Skip to main content
POST
Upload a document

Authorizations

x-api-key
string
header
required

Body

multipart/form-data
file
file
required

Document file. Allowed types (validated by inspecting the file's magic bytes, not the filename or Content-Type header): application/pdf, image/jpeg, image/png. Maximum size: 10 MB.

purpose
enum<string>

What the document is for. A payout or order accepts only transaction_support in documents; an RFI reply accepts only rfi_response in documentIds.

Available options:
organization_onboarding,
kyc,
feature_request,
transaction_support,
rfi_response
name
string

Human-readable label for the document.

type
enum<string>

The requirement slot you uploaded this file against, from documents[].canonicalType in the requirements response, or a payout's acceptedDocumentTypes, including other. Upper or lower case: invoice and INVOICE both record INVOICE. Sending it shows the file against that slot; Conduit still identifies the document itself, and that determination is what applies.

Available options:
BUSINESS_REGISTRATION,
ARTICLES_OF_INCORPORATION,
TAX_CERTIFICATE,
OPERATING_LICENSE,
REGULATORY_LICENSE,
SHAREHOLDERS_REGISTRY,
DIRECTORS_REGISTRY,
AUTHORIZATION_TO_ACT,
PROOF_OF_ADDRESS,
CERTIFICATE_OF_GOOD_STANDING,
FLOW_OF_FUNDS,
AUDITED_FINANCIAL_STATEMENT,
BANK_STATEMENT,
ORG_STRUCTURE_CHART,
AML_AUDIT,
COMPLIANCE_POLICY,
INSTITUTIONAL_INVESTOR_DOCUMENTATION,
IDENTITY_VERIFICATION,
IDENTITY_VERIFICATION_ATTESTATION,
EDD_EVIDENCE,
BANK_VERIFICATION_LETTER,
INVOICE,
CONTRACT,
PAYROLL_REGISTER,
INVESTMENT_AGREEMENT,
OTHER,
business_registration,
articles_of_incorporation,
tax_certificate,
operating_license,
regulatory_license,
shareholders_registry,
directors_registry,
authorization_to_act,
proof_of_address,
certificate_of_good_standing,
flow_of_funds,
audited_financial_statement,
bank_statement,
org_structure_chart,
aml_audit,
compliance_policy,
institutional_investor_documentation,
identity_verification,
identity_verification_attestation,
edd_evidence,
bank_verification_letter,
invoice,
contract,
payroll_register,
investment_agreement,
other
eddEvidenceKind
enum<string>

Which kind of evidence the file is. Required when type is EDD_EVIDENCE, and refused with any other type.

Available options:
payslip_or_employment_letter,
tax_return,
sale_of_asset_or_inheritance,
bank_statement

Response

id
string
required

Unique document identifier

Pattern: ^doc_[0-9A-Za-z]{22}$
classificationStatus
enum<string>
required

Server-side classifier lifecycle: pending (not yet run), completed (a verdict was produced — the type set may be empty), or failed (the classifier could not complete: the file may be unreadable, or a transient vendor/network error was exhausted). Transient failures are re-attempted on the next review run; a persistent failed warrants re-uploading a clearer file. A document that is never submitted with an application stays pending, a payout or order supporting document included.

Available options:
pending,
completed,
failed
createdAt
string<date-time>
required

Timestamp when the document was uploaded

Example:

"2026-01-15T09:30:00.000Z"

updatedAt
string<date-time>
required

Timestamp when the document was last updated

Example:

"2026-01-15T09:30:00.000Z"

fileName
string

Original file name as uploaded

Example:

"passport-scan.pdf"

mimeType
string

MIME type of the uploaded file

Example:

"application/pdf"

name
string

Human-readable label for the document

Example:

"John Doe Passport"

classifiedTypes
enum<string>[]

Canonical document types assigned by the server-side classifier. Omitted until classification runs (asynchronously, after the document is attached to a submitted application); the type declared at upload is stored separately and does not populate this field.

Available options:
BUSINESS_REGISTRATION,
ARTICLES_OF_INCORPORATION,
TAX_CERTIFICATE,
OPERATING_LICENSE,
REGULATORY_LICENSE,
SHAREHOLDERS_REGISTRY,
DIRECTORS_REGISTRY,
AUTHORIZATION_TO_ACT,
PROOF_OF_ADDRESS,
CERTIFICATE_OF_GOOD_STANDING,
FLOW_OF_FUNDS,
AUDITED_FINANCIAL_STATEMENT,
BANK_STATEMENT,
ORG_STRUCTURE_CHART,
AML_AUDIT,
COMPLIANCE_POLICY,
INSTITUTIONAL_INVESTOR_DOCUMENTATION,
IDENTITY_VERIFICATION,
IDENTITY_VERIFICATION_ATTESTATION,
EDD_EVIDENCE,
BANK_VERIFICATION_LETTER,
INVOICE,
CONTRACT,
PAYROLL_REGISTER,
INVESTMENT_AGREEMENT,
OTHER
eddEvidenceKind
enum<string>

Which kind of enhanced due diligence evidence the uploader declared, for a document uploaded with type=EDD_EVIDENCE. Omitted for any other document.

Available options:
payslip_or_employment_letter,
tax_return,
sale_of_asset_or_inheritance,
bank_statement
purpose
enum<string>

What the document was uploaded for, as declared by the uploader. Omitted when the upload declared none. Only a transaction_support document can be attached to a payout or an order.

Available options:
organization_onboarding,
kyc,
feature_request,
transaction_support,
rfi_response
fileSize
integer

Size in bytes. Omitted for documents uploaded before size capture was added.

Required range: -9007199254740991 <= x <= 9007199254740991