Retrieve a specific document

{ "document_id": "doc_01j9x8m2k7qpzwv3t5r6y8n0ab", "object": "document", "owner_type": "investor", "owner_id": "01j9x8m2k7qpzwv3t5r6y8n0cd", "purpose": "kyc", "document_type": "PASSPORT", "file_name": "passport-front.png", "mime_type": "image/png", "file_size": 524288, "status": "uploaded", "expires_at": null, "uploaded_at": "2025-01-10T09:00:00Z", "metadata": null }

Authorizations

Authorization

string

header

required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Path Parameters

document_id

string<uuid>

required

Example:

"doc_a1b2c3d4e5f6g7h8"

Response

Document details retrieved successfully

Document resource returned by /v1/documents endpoints. Uses the flat document shape: document_id is the public id, owner_type / owner_id are polymorphic ownership refs (INVESTOR / USER / TENANT). purpose indicates what the doc is for (KYC, KYB, EDD, TAX, FUNDING_VERIFICATION, AGREEMENT, OTHER).

document_id

string

required

Example:

"doc_01j9x8m2k7qpzwv3t5r6y8n0ab"

object

enum<string>

required

Available options:

document

owner_type

enum<string>

required

Available options:

tenant,

investor,

user

owner_id

string

required

UUID of the owning entity (raw, not prefix-encoded).

document_type

string

required

Free-form classifier (e.g. PASSPORT, BANK_STATEMENT, CIP_RESULT).

Example:

"id_verification"

file_name

string

required

Example:

"id-front.png"

mime_type

string

required

Example:

"image/png"

status

enum<string>

required

Available options:

uploaded,

processing,

accepted,

rejected,

expired

uploaded_at

string<date-time>

required

purpose

enum<string> | null

Available options:

kyc,

kyb,

edd,

tax,

funding_verification,

agreement,

account_statement,

trade_confirmation,

other

file_size

integer | null

expires_at

string<date-time> | null

metadata

object