API reference
REST API for Common Ridge workspaces. Authenticate with `Authorization: Bearer <api key>`. Lists are cursor paginated (default page size 50, maximum 200; these are page-size conventions). Writes accept an `Idempotency-Key` header. Scopes: investors:read, investors:write, entities:read, funds:read, commitments:read, commitments:write, capital_accounts:read, transactions:read, capital_calls:read, distributions:read, documents:read, documents:write, statements:read, envelopes:read, tax_documents:read, webhooks:manage.
Preview schema, version 1.0.0. Paths and fields are placeholders and will change before release. The machine-readable schema is at /openapi.json.
Base URL
- /api/v1 Relative to your workspace API host
Endpoints
get
/investorsList investors
Required scope: `investors:read` (or the matching :write scope).
limit(query)cursor(query)kind(query)
post
/investorsCreate an investor
Required scope: `investors:write`. Accepts an Idempotency-Key header.
get
/investors/{id}Get one of investors
Required scope: `investors:read` (or the matching :write scope).
id(path, required)
get
/entitiesList investing entities
Required scope: `entities:read` (or the matching :write scope).
limit(query)cursor(query)kind(query)
get
/entities/{id}Get one of investing entities
Required scope: `entities:read` (or the matching :write scope).
id(path, required)
get
/fundsList funds
Required scope: `funds:read` (or the matching :write scope).
limit(query)cursor(query)
get
/funds/{id}Get one of funds
Required scope: `funds:read` (or the matching :write scope).
id(path, required)
get
/commitmentsList commitments
Required scope: `commitments:read` (or the matching :write scope).
limit(query)cursor(query)fund_id(query)investor_entity_id(query)status(query)
post
/commitmentsRecord an accepted commitment (creates the capital account)
Required scope: `commitments:write`. Accepts an Idempotency-Key header.
get
/commitments/{id}Get one of commitments
Required scope: `commitments:read` (or the matching :write scope).
id(path, required)
get
/capital-accountsList capital accounts
Required scope: `capital_accounts:read` (or the matching :write scope).
limit(query)cursor(query)fund_id(query)investor_entity_id(query)
get
/capital-accounts/{id}Get one of capital accounts
Required scope: `capital_accounts:read` (or the matching :write scope).
id(path, required)
get
/transactionsList investor transactions
Required scope: `transactions:read` (or the matching :write scope).
limit(query)cursor(query)fund_id(query)capital_account_id(query)kind(query)
get
/transactions/{id}Get one of investor transactions
Required scope: `transactions:read` (or the matching :write scope).
id(path, required)
get
/capital-callsList capital calls
Required scope: `capital_calls:read` (or the matching :write scope).
limit(query)cursor(query)fund_id(query)status(query)
get
/capital-calls/{id}Get one of capital calls
Required scope: `capital_calls:read` (or the matching :write scope).
id(path, required)
get
/distributionsList distributions
Required scope: `distributions:read` (or the matching :write scope).
limit(query)cursor(query)fund_id(query)status(query)
get
/distributions/{id}Get one of distributions
Required scope: `distributions:read` (or the matching :write scope).
id(path, required)
get
/documentsList documents (metadata only)
Required scope: `documents:read` (or the matching :write scope).
limit(query)cursor(query)fund_id(query)type(query)
post
/documentsCreate a document record and get an upload target
Required scope: `documents:write`. Accepts an Idempotency-Key header.
get
/documents/{id}Get one of documents (metadata only)
Required scope: `documents:read` (or the matching :write scope).
id(path, required)
get
/statementsList published capital account statements
Required scope: `statements:read` (or the matching :write scope).
limit(query)cursor(query)capital_account_id(query)
get
/statements/{id}Get one of published capital account statements
Required scope: `statements:read` (or the matching :write scope).
id(path, required)
get
/envelopesList e-sign envelopes (status)
Required scope: `envelopes:read` (or the matching :write scope).
limit(query)cursor(query)status(query)
get
/envelopes/{id}Get one of e-sign envelopes (status)
Required scope: `envelopes:read` (or the matching :write scope).
id(path, required)
get
/tax-documentsList tax documents
Required scope: `tax_documents:read` (or the matching :write scope).
limit(query)cursor(query)fund_id(query)investor_entity_id(query)tax_year(query)
get
/tax-documents/{id}Get one of tax documents
Required scope: `tax_documents:read` (or the matching :write scope).
id(path, required)
post
/documents/{id}/completeTell us the upload finished: the file is scanned now (the document is published separately, once the scan is clean)
Required scope: `documents:write`. Accepts an Idempotency-Key header.
id(path, required)
post
/documents/{id}/publishPublish a document to its audience; only a scanned, sanitized file (scan_status READY) can be published
Required scope: `documents:write`. Accepts an Idempotency-Key header.
id(path, required)
get
/webhooksList webhook endpoints
Required scope: `webhooks:manage`.
post
/webhooksCreate a webhook endpoint (secret shown once)
Required scope: `webhooks:manage`. Accepts an Idempotency-Key header.
delete
/webhooks/{id}Delete a webhook endpoint
Required scope: `webhooks:manage`. Accepts an Idempotency-Key header.
id(path, required)
Webhook events
Events delivered to your endpoint. See the webhooks guide for signature verification and retries.
investor.createdinvestor.created
investor.updatedinvestor.updated
subscription.status_changedsubscription.status_changed
commitment.acceptedcommitment.accepted
capital_call.issuedcapital_call.issued
capital_call.item_paidcapital_call.item_paid
capital_call.closedcapital_call.closed
distribution.approveddistribution.approved
distribution.paiddistribution.paid
payment.status_changedpayment.status_changed
document.publisheddocument.published
document.vieweddocument.viewed
statement.publishedstatement.published
envelope.completedenvelope.completed
envelope.declinedenvelope.declined
period.closedperiod.closed
nav.publishednav.published
tax_document.deliveredtax_document.delivered
bank_account.changedbank_account.changed