Skip to main content
POST
/
documents
Upload a document
curl --request POST \
  --url https://api.conduit.financial/v2/documents \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form file='@example-file' \
  --form 'name=<string>'
{
  "id": "<string>",
  "createdAt": "2026-01-15T09:30:00.000Z",
  "updatedAt": "2026-01-15T09:30:00.000Z",
  "fileName": "passport-scan.pdf",
  "mimeType": "application/pdf",
  "name": "John Doe Passport",
  "classifiedTypes": [],
  "fileSize": 0
}

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>

Purpose of the document.

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

Human-readable label for the document.

Response

​
id
string
required

Unique document identifier

Pattern: ^doc_[0-9A-Za-z]{22}$
​
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. Set immediately when the integrator declares a type at upload; updated when the server-side classifier runs.

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,
bank_verification_letter,
invoice,
contract,
payroll_register,
investment_agreement
​
purpose
enum<string>

Purpose of the document within the onboarding or KYC flow.

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

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

Required range: -9007199254740991 <= x <= 9007199254740991