Documents

Document uploading and management functions for supporting applications, payments, withdrawals, and other operations that require verification.

Endpoints

POST /documents/{id}/upload Upload document GET /documents/{id} Download document

POST /documents/{id}/upload

Upload a document to satisfy an application requirement or RFI (Request for Information).

Path Parameters

Parameter	Type	Description
`id` required	string	The document requirement ID (from application status or RFI)

Request

Send the document as multipart/form-data:

Field	Type	Description
`file` required	file	The document file (PDF, PNG, JPG)
`description`	string	Optional description of the document

Example Request

Request

POST /documents/doc_req_001/upload HTTP/1.1
Host: api.bultra.com
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: multipart/form-data; boundary=----FormBoundary

------FormBoundary
Content-Disposition: form-data; name="file"; filename="passport.pdf"
Content-Type: application/pdf

[Binary file data]
------FormBoundary
Content-Disposition: form-data; name="description"

Front page of passport
------FormBoundary--

Response

200 OK

{
  "id": "doc_req_001",
  "type": "PASSPORT",
  "status": "UPLOADED",
  "filename": "passport.pdf",
  "size": 245678,
  "uploaded_at": "2026-01-15T10:30:00Z"
}

Supported File Types

PDF: application/pdf (max 10MB)
PNG: image/png (max 10MB)
JPG/JPEG: image/jpeg (max 10MB)

GET /documents/{id}

Download a previously uploaded document.

Path Parameters

Parameter	Type	Description
`id` required	string	The document ID

Response

Returns the document file with appropriate content type.

200 OK

Content-Type: application/pdf
Content-Disposition: attachment; filename="passport.pdf"
Content-Length: 245678

[Binary file data]

Document Types

The following document types may be requested:

Identity Documents

Type	Description
`PASSPORT`	Valid passport (photo page)
`DRIVERS_LICENSE_FRONT`	Front of driver's license
`DRIVERS_LICENSE_BACK`	Back of driver's license
`ID_CARD_FRONT`	Front of national ID card
`ID_CARD_BACK`	Back of national ID card

Address Documents

Type	Description
`PROOF_OF_ADDRESS`	Utility bill, bank statement (within 3 months)
`UTILITY_BILL`	Utility bill showing name and address
`BANK_STATEMENT`	Bank statement showing name and address

Corporate Documents

Type	Description
`CERTIFICATE_OF_INCORPORATION`	Company incorporation certificate
`ARTICLES_OF_ASSOCIATION`	Company articles or bylaws
`SHAREHOLDER_REGISTER`	Register of shareholders
`DIRECTOR_REGISTER`	Register of directors

Transaction Documents (RFI)

Type	Description
`INVOICE`	Invoice for goods or services
`CONTRACT`	Contract or agreement
`RECEIPT`	Payment receipt
`OTHER`	Other supporting documentation

Document Status

Status	Description
`PENDING`	Document upload required
`UPLOADED`	Document uploaded, awaiting review
`APPROVED`	Document approved
`REJECTED`	Document rejected, re-upload required