Supergood | Imprima API
Programmatically access Imprima virtual data rooms, documents, permissions, and Q&A workflows with a stable REST API. Supergood builds and operates production-grade, unofficial Imprima integrations so your team can automate due diligence and deal workflows without heavy custom engineering.
Plain English: Imprima is virtual data room (VDR) software used by deal teams in M&A, real estate, and capital markets to share sensitive documents, manage bidder questions, and track activity securely. An unofficial API lets you programmatically pull data room lists, folder structures, documents, users/groups, permissions, Q&A threads, and audit activity—and push uploads, permissions updates, and new Q&A into Imprima.
For a tech company integrating with Imprima, this means you can ingest real-time document trees and engagement metrics to power analytics, sync content with your DMS (e.g., SharePoint, Box), automate buyer Q&A workflows from your product, bulk-provision users and groups, or archive documents and logs for compliance. You can also standardize watermarking choices, enforce permission templates, export deal binders on close, and keep stakeholder systems (legal DMS, CRM, analytics, compliance archives) in lockstep.
What is Imprima?
Imprima (https://www.imprima.com/) is a secure Virtual Data Room platform for mergers and acquisitions, fundraising, real estate transactions, and other confidential processes. Teams use Imprima to structure deal rooms, control document access with granular permissions and dynamic watermarking, coordinate Q&A between buy- and sell-side, and maintain complete audit trails.
Core product areas include:
- Data Rooms & Projects (room setup, phases, archiving)
- Document Management (folders, bulk upload, versioning, indexing)
- Security & Permissions (user/groups, roles, NDA/terms, watermarking)
- Q&A Management (question routing, answer approvals, bidder visibility)
- Reporting & Audit (activity tracking, exports, engagement analytics)
Common data entities:
- DataRooms (metadata, deal type, status)
- Folders & Documents (versions, classifications, watermarks)
- Users & Groups (roles, bidder/seller sides, entitlements)
- Permissions (room/folder/document-level capabilities)
- Q&A Threads, Questions, Answers (topics, routing, status)
- Activity/Audit Logs (views, downloads, permission changes)
The Imprima Integration Challenge
Deal teams rely on Imprima daily, but turning portal-first workflows into API-driven automation is non-trivial:
- Role-aware views: Buy-side, sell-side, and advisors see different folder trees, watermarks, and Q&A states
- Security rigor: Dynamic watermarks, NDA acceptance, and granular permission matrices require careful handling
- Limited public APIs: Many tenants lack an officially provisioned API; export options are optimized for UI use
- Large file handling: Chunked uploads, virus scanning, and asynchronous processing complicate automation
- Data sprawl: Documents, versions, Q&A, and activity context live across multiple modules and reports
- SSO/MFA: Enterprise SSO and multi-factor authentication complicate headless automation
We also hear common complaints: bulk exports and Q&A downloads are manual and time-consuming, preserving folder structure and permissions in downstream systems is error-prone, and any native API access is gated or costly for some tenants. Teams want reliable automation without changing their VDR provider.
How Supergood Creates Imprima APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Imprima tenant.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes responses so you can integrate once and rely on consistent objects across modules
- Aligns with customer entitlements and role-based permissions to ensure compliant access
- Supports chunked uploads and time-limited download links with watermark controls where applicable
Use Cases
Document & Folder Sync
- Mirror room/folder/document trees into your DMS (SharePoint, Box) with metadata and versioning
- Normalize classifications, retention, and watermark profiles across deals
- Automate binder creation and archiving at close
Q&A Orchestration
- Ingest questions in real-time, route to subject matter experts, and post approved answers back
- Trigger SLA alerts on unanswered questions and surface themes for analytics
- Export Q&A logs to legal matter management or BI
User & Permission Lifecycle
- Provision users and bidder groups automatically from CRM/deal pipeline
- Apply permission templates to folders and keep changes in sync across rooms
- Enforce NDA/terms acceptance and watermark policies programmatically
Compliance & Reporting
- Pull activity/audit logs for surveillance and regulatory archives
- Track engagement metrics (views, downloads) for deal analytics
- Validate that permissions and watermarks adhere to policy
Available Endpoints
Authentication
POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/sessions \
--header 'Authorization: Basic <Base64 encoded token>' \
--header 'Content-Type: application/json' \
--data '{
"username": "[email protected]",
"password": "<password>",
"mfa": { "type": "totp", "code": "123456" }
}'
Example response
{
"authToken": "eyJhbGciOi...",
"expiresIn": 3600,
"user": {
"id": "u_imp_7a2f10",
"name": "Deal Manager",
"entitlements": ["data_rooms", "documents", "permissions", "qna"]
}
}
POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.
Data Rooms
GET /data-rooms: List data rooms with filters and summary details.
Query parameters
- status: active | archived | closed | setup
- role: buy_side | sell_side | advisor
- updatedFrom, updatedTo: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"roomId": "room_4f9c21",
"name": "Project Atlas – Sell Side",
"dealType": "m_and_a",
"status": "active",
"createdAt": "2026-01-10T09:22:00Z",
"updatedAt": "2026-01-22T14:15:43Z",
"owner": {"id": "u_imp_7a2f10", "name": "Deal Manager"},
"participants": {"buySideGroups": 5, "sellSideGroups": 2},
"documentCounts": {"folders": 42, "documents": 1180, "versions": 1432}
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Documents
POST /data-rooms/{roomId}/documents: Upload a document to a folder with metadata, permission hints, and watermark options.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/data-rooms/room_4f9c21/documents \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"folderPath": "/Financials/2024/Q1",
"fileName": "Q1_Management_Accounts.pdf",
"sizeBytes": 8243921,
"checksumSha256": "5f16d9...a2c",
"classification": "confidential",
"watermark": {"enabled": true, "template": "bidder_name_timestamp"},
"versionNote": "Initial upload",
"permissions": [
{"groupId": "grp_buy_28", "access": "view"},
{"groupId": "grp_sell_02", "access": "download"}
],
"upload": {"strategy": "multipart", "parts": 5}
}'
Example response
{
"documentId": "doc_9b7e51",
"versionId": "ver_01",
"status": "processing",
"folderPath": "/Financials/2024/Q1",
"watermark": {"enabled": true},
"createdAt": "2026-01-22T15:03:11Z",
"next": {
"multipart": {
"uploadId": "upl_08ab73",
"parts": [
{"partNumber": 1, "url": "https://uploads.supergood.ai/..."},
{"partNumber": 2, "url": "https://uploads.supergood.ai/..."}
]
}
}
}
Q&A
POST /data-rooms/{roomId}/qna/questions: Create a buy-side question and route it to the appropriate topic/owner for approval.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/data-rooms/room_4f9c21/qna/questions \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"subject": "Clarify revenue recognition policy",
"body": "Please confirm recognition timing for multi-year maintenance contracts.",
"topic": "Accounting Policies",
"bidderGroupId": "grp_buy_28",
"attachments": [
{"fileName": "context.xlsx", "uploadToken": "upl_7fa223"}
],
"references": [
{"documentId": "doc_9b7e51", "page": 12}
],
"customerVisible": true
}'
Example response
{
"questionId": "q_51af80",
"status": "submitted",
"topic": "Accounting Policies",
"routedTo": {"groupId": "grp_sell_02", "approver": "Controller"},
"createdAt": "2026-01-22T16:20:44Z"
}
Technical Specifications
- Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
- Response format: JSON with consistent resource schemas and pagination across modules
- Rate limits: Tuned for enterprise throughput while honoring customer entitlements and usage controls
- Session management: Automatic reauth and cookie/session rotation with health checks
- Data freshness: Near real-time retrieval of rooms, folders/documents, permissions, Q&A, and activity summaries
- Security: Encrypted transport, scoped tokens, and audit logging; respects Imprima role-based permissions and watermark policies
- Webhooks: Optional asynchronous delivery for long-running workflows (e.g., large uploads, Q&A approvals)
Performance Characteristics
- Latency: Sub-second responses for list/detail queries under normal load
- Throughput: Designed for high-volume document sync and Q&A processing across multiple rooms
- Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
- Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened Imprima adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Imprima evolves.
Frequently Asked Questions
Q: Which Imprima modules can this integration cover?
Supergood supports workflows across commonly used modules such as Data Rooms (rooms, folders, documents), Security (users, groups, permissions, watermarking policies), Q&A (questions, routing, approvals), and Reporting (activity summaries, exports), subject to your licensing and entitlements. We scope coverage during integration assessment.
Q: How are MFA and SSO handled for automation?
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
Q: Can you export full data rooms and Q&A for our archives?
Yes. We can deliver watermarked or original document exports with preserved folder structure, plus Q&A logs (questions, answers, topics, attachments) normalized to your archive format. We can also provide time-limited download URLs and checksum manifests for validation.
Q: Imprima doesn’t expose a public API for our tenant. Can Supergood still automate it?
In most cases, yes. We reverse-engineer authenticated browser flows and honor your role-based permissions to provide a stable, unofficial API surface. Your Imprima licensing and entitlements must permit the actions you request; we don’t bypass security controls.
Q: How do you manage watermark rules and permission changes safely?
We model watermark profiles and permission matrices explicitly in our schemas and validate updates against policy. All access is scoped to the acting user’s entitlements with full audit logs.
Related Integrations
Intralinks API - Programmatically access the Intralinks VDR with Supergood
Ready to automate your Imprima workflows?
Supergood can have your Imprima integration live in days with no ongoing engineering maintenance.
