Ansarada

Supergood | Ansarada API

Alex Klarfeld

Alex Klarfeld

— 6 min read

Programmatically access Ansarada data rooms, deal participants, documents, and Q&A workflows with a stable REST API. Supergood builds and operates production-grade, unofficial Ansarada integrations so your team can automate deal preparation, diligence, and governance workflows without heavy custom engineering.

Plain English: Ansarada is a virtual data room and deal management platform used for M&A, fundraising, tenders, and governance. An unofficial API lets you pull room lists, participants, folders/files, document metadata, and Q&A threads—and push new questions, uploads, permissions, and exports back into Ansarada.

For a tech company integrating with Ansarada, this means you can ingest real-time room and bidder activity to power dashboards, auto-sync diligence documents to your archive, automate Q&A triage from your app, trigger exports for compliance, and keep upstream systems (CRM, DMS, analytics, GRC) aligned. Teams often cite friction around bulk exports, automating bidder invitations/permissions, and limited or enterprise-tier API access; an unofficial API helps remove these bottlenecks while respecting roles and security controls.

What is Ansarada?

Ansarada (https://www.ansarada.com/) is a cloud platform best known for its virtual data rooms (VDRs) used in mergers & acquisitions, capital raises, asset sales, and tenders. It also offers deal workflow tools, AI insights, and governance/board capabilities. Core functionality includes secure document sharing with granular permissions, watermarking and redaction, Q&A workflows between buyers and sellers, bidder/participant management, activity reporting and audit trails, and one-click exports for archiving.

Core product areas include:

  • Virtual Data Rooms (Rooms, Folders, Documents, Versioning, Watermarking, Redaction)
  • Deal Management (Pipelines, Stages, Checklists, Task Assignments)
  • Q&A (Question intake, Routing, Answer approval, Buyer/Seller visibility)
  • Participants (Bidders, Advisors, Internal deal team, Roles/Groups, Permissions)
  • Reporting & Compliance (Engagement analytics, Audit logs, Exports/Archives)

Common data entities:

  • Organizations, Users, Groups/Roles (Seller, Buyer/Bidder, Advisor)
  • Rooms/Deals (status, deal type, industry, stage)
  • Folders/Documents (path, version, size, hashes, labels, permissions)
  • Q&A Threads (questions, answers, categories, attachments, status)
  • Participants (bidder groups, invitations, NDAs, access scopes)
  • Exports (document bundles, Q&A exports, audit trails)

The Ansarada Integration Challenge

Deal teams rely on Ansarada daily, but turning portal-first workflows into API-driven automation is challenging:

  • Role-aware controls: Buyers, sellers, and advisors see different content; permissions, watermarking, and redaction vary by group
  • Q&A governance: Routing, answer approvals, and disclosure controls must be modeled to avoid data leakage
  • Secure document handling: Viewer-only modes, download restrictions, and protected links complicate headless access
  • Authentication complexity: SSO/MFA and session rotation can break scripts without resilient session management
  • Data spread: Critical context spans rooms, participants, Q&A, and reporting with important metadata in multiple views

How Supergood Creates Ansarada APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Ansarada 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 rooms, documents, and Q&A
  • Aligns with customer entitlements and role-based permissions to ensure compliant access

Use Cases

Deal & Participant Data Sync

  • Mirror rooms, stages, and bidder groups into your CRM or data warehouse
  • Keep status and engagement metrics current for analytics and pipeline health
  • Normalize deal types, industries, and stages across portfolios

Document Intake & Permissions Automation

  • Bulk upload structured folders with pre-set sensitivity labels and watermarking
  • Apply permission templates by bidder group and room stage
  • Sync finalized documents to your DMS/records archive with checksums

Q&A Automation

  • Ingest questions to triage/assign in your internal workflow tool
  • Post answers with approval metadata and correct visibility to bidder groups
  • Track SLAs and trigger alerts when threshold times are exceeded

Compliance & Reporting

  • Generate export bundles (documents + Q&A + audit) on close
  • Feed activity logs into your SIEM for monitoring and retention
  • Provide stakeholders read-optimized mirrors without manual downloads

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_ans_7b210e",
    "name": "Deal Operations",
    "entitlements": ["rooms", "documents", "participants", "qna", "exports"]
  }
}

POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

Rooms

GET /rooms: List rooms with filters and summary details.

Query parameters

  • ownerOrgId: string
  • status: active | preparing | closed | archived
  • dealType: m_and_a | fundraising | tender | other
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "roomId": "rm_2f91c0",
      "name": "Project Atlas Sale",
      "dealType": "m_and_a",
      "status": "active",
      "ownerOrgId": "org_91aa2e",
      "ownerOrgName": "Atlas Holdings Pty Ltd",
      "industry": "Industrial",
      "bidderCount": 7,
      "documentCount": 1824,
      "qnaOpenCount": 46,
      "createdAt": "2026-01-05T09:12:11Z",
      "updatedAt": "2026-01-22T14:33:27Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Documents

GET /rooms/{roomId}/documents: List folders and files with metadata and permission hints. Optionally include signed download URLs when allowed by policy.

Query parameters

  • path: string (folder path prefix, e.g., "/Finance/")
  • recursive: true | false
  • include: comma-separated values, supports downloadUrl
  • updatedFrom: ISO 8601 timestamp
  • page, pageSize: integers for pagination
curl --request GET \
  --url "https://api.supergood.ai/integrations/<integration_id>/rooms/rm_2f91c0/documents?path=/Finance/&recursive=true&include=downloadUrl&page=1&pageSize=200" \
  --header 'Authorization: Bearer <authToken>'

Example response

{
  "items": [
    {
      "nodeId": "nd_8a210b",
      "type": "file",
      "name": "FY25_PandL.pdf",
      "path": "/Finance/Statements/",
      "version": 3,
      "size": 982341,
      "sha256": "3f8a...c912",
      "labels": ["confidential"],
      "watermark": { "enabled": true },
      "permissions": { "view": true, "download": false },
      "downloadUrl": null,
      "updatedAt": "2026-01-21T17:02:44Z"
    },
    {
      "nodeId": "nd_8a210c",
      "type": "folder",
      "name": "Tax",
      "path": "/Finance/",
      "updatedAt": "2026-01-18T11:31:05Z"
    }
  ],
  "page": 1,
  "pageSize": 200,
  "total": 2
}

Q&A

POST /rooms/{roomId}/qa/questions: Submit a buyer question with routing details and optional document linkage.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/rooms/rm_2f91c0/qa/questions \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "question": "Please confirm revenue recognition policy for multi-year contracts.",
    "categoryId": "cat_fin_policies",
    "documentId": "nd_8a210b",
    "bidderGroupId": "bg_44d1a9",
    "priority": "high",
    "attachments": [
      {"fileName": "revrec_context.txt", "uploadToken": "upl_09fe71"}
    ],
    "notify": true
  }'

Example response

{
  "questionId": "q_51af80",
  "status": "submitted",
  "reference": "BG12-0017",
  "createdAt": "2026-01-21T11:20:44Z"
}

Exports

POST /rooms/{roomId}/exports/bundles: Request a bulk export of selected folders and optional Q&A into a secure archive.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/rooms/rm_2f91c0/exports/bundles \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "includePaths": ["/Finance/", "/Legal/"] ,
    "includeQna": true,
    "format": "zip",
    "watermark": true,
    "redaction": "none",
    "referenceId": "close-archive-2026-01-31"
  }'

Example response

{
  "exportId": "exp_90e412",
  "status": "pending",
  "estimatedReadyAt": "2026-01-21T12:05:00Z",
  "downloadUrl": null
}

Get full API Specs →

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, documents, participants, Q&A, and export artifacts
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Ansarada role-based permissions including bidder/seller separations
  • Webhooks: Optional async delivery for long-running workflows (e.g., export completion, Q&A updates)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume document listing and Q&A processing
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened Ansarada adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Ansarada evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which Ansarada modules can this integration cover?

Supergood supports workflows across commonly used modules such as Rooms (metadata, participants), Documents (folders, versions, permissions), Q&A (questions, answers, categories), and Exports (bundles, audit trails), 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 automate bulk exports for closing binders and compliance?

Yes. We can generate room export bundles—including selected folders, Q&A, and audit logs—and deliver time-limited download URLs or push artifacts to your DMS/S3 with checksum validation.

Q: Can you manage bidder permissions and document visibility?

We can apply permission templates by bidder group and path, respect watermarking and download restrictions, and validate that visibility lines up with your governance rules before changes are committed.

Ready to automate your Ansarada workflows?

Supergood can have your Ansarada integration live in days with no ongoing engineering maintenance.

Get Started →

Read more