Upload Document

Uploads a document file to the system. The uploaded document can later be attached to an application entity (company or individual) using the Add Application Document endpoint.

Request

https://openapi.advance.ai/v1/business/documents
POST (multipart/form-data)

Request Header Parameters

Parameter	Description
Authorization	`string` Please use Token Authentication API to get your access token. Format: `Bearer {token}`
Content-Type	multipart/form-data

Request Parameters

Parameter	Required	Description
content	True	`file` The document file to upload. Maximum size: 10MB.
module	False	`enum` The business module for this upload. Defaults to APPLICATION_ATTACHMENT.
documentType	Conditional	`enum` The type of document being uploaded. Required when module is APPLICATION_ATTACHMENT.

Supported File Types

MIME Type	Description
application/pdf	PDF documents
image/jpeg	JPEG images
image/png	PNG images
application/msword	Microsoft Word documents (.doc)
application/vnd.openxmlformats-officedocument.wordprocessingml.document	Microsoft Word documents (.docx)
application/vnd.ms-excel	Microsoft Excel spreadsheets (.xls)
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet	Microsoft Excel spreadsheets (.xlsx)
text/csv	CSV files

UploadBizModuleEnum

Value	Description
QUESTIONNAIRE_IMAGE	Image for questionnaire (max 10MB, TTL 30 min)
QUESTIONNAIRE_ATTACHMENT	Attachment for questionnaire (max 10MB, TTL 60 min)
APPLICATION_ATTACHMENT	Attachment for application (max 10MB, TTL 3 min)

DocumentTypeEnum - Company Documents

Value	Description	Expected Fields
CERTIFICATE_OF_REGISTRATION	Certificate of incorporation/registration	Country, (state), registration authority, registration date, company name, registration number, legal form type.
MEMORANDUM_O_REGISTRATION	Memorandum of incorporation/association/registration	Country, (state), company name, incorporation date.
RECENT_EXCERPT	Recent excerpt from a state company registry	Country, (state), registration authority, registration date, name, reg number, status, address, date of export, legal form type.
STATEMENT_OF_INFORMATION	Statement of information	Country, (state), name, registration number, date of document issue, issuing authority, legal form type.
PROOF_OF_ADDRESS	Proof of address	Company name, registration number, address, date of issue, type of the PoA, issuing authority.
CERTIFICATE_OF_INCUMBENCY	Certificate of incumbency	Country, (state), name, registration number, status, address, date of issue, list of shareholders, list of directors.
CERTIFICATE_OF_GOOD_STANDING	Certificate of good standing	Country, (state), issuing authority, registration date, name, reg number, status, address, date of issue.
SHAREHOLDER_REGISTRY	Shareholder registry	Company name, registration number, list of shareholders, date of issue.
DIRECTOR_REGISTRY	Director registry	Company name, registration number, list of directors, date of issue.
TRUST_AGREEMENT	Trust agreement	Country, (state), registration date, trust name, date of issue, beneficiary(s), trustee, settlor.
POWER_OF_ATTORNEY	Power of attorney	Country, (state), company name, date of issue, date of expiration, names of director(s), name of representative(s).
COMPANY_OTHERS	Company other documents	Other company documents that do not fit into the above categories.

DocumentTypeEnum - Individual Documents

Value	Description	Expected Fields
PASSPORT	Passport	Country of issue, passport number, date of issue, date of expiration, name as on passport.
ID_CARD	ID card	Country of issue, ID card number, date of issue, date of expiration, name as on ID card.
DRIVERS_LICENSE	Driver's license	Country of issue, driver's license number, date of issue, date of expiration, name as on driver's license.
RESIDENCE_PERMIT	Residence permit	Country of issue, residence permit number, date of issue, date of expiration, name as on residence permit.
INDIVIDUAL_OTHERS	Individual other documents	Other individual documents that do not fit into the above categories.

Request Examples

curl -X POST "https://openapi.advance.ai/v1/business/documents" \
-H "Authorization: Bearer {Your Access Token}" \
-F "content=@/path/to/certificate.pdf" \
-F "module=APPLICATION_ATTACHMENT" \
-F "documentType=CERTIFICATE_OF_REGISTRATION"

curl -X POST "https://openapi.advance.ai/v1/business/documents" \
-H "Authorization: Bearer {Your Access Token}" \
-F "content=@/path/to/passport.pdf" \
-F "module=APPLICATION_ATTACHMENT" \
-F "documentType=PASSPORT"

Success Response

Response Description

Field	Description
documentId	`string` The unique identifier of the uploaded document. Use this ID to attach the document to an application.
documentFormat	`enum` The format of the uploaded file (PDF, JPEG, PNG, etc.).
documentDir	`string` The storage directory path of the document.
mimeType	`string` The MIME type of the uploaded file.
documentType	`enum` The type of document.
documentSize	`integer` The size of the document in bytes.
originalName	`string` The original filename of the uploaded document.

Response Examples

{
  "documentId": "DOC-2026052200001",
  "documentFormat": "PDF",
  "documentDir": "/documents/2026/05/22/DOC-2026052200001",
  "mimeType": "application/pdf",
  "documentType": "CERTIFICATE_OF_REGISTRATION",
  "documentSize": 1048576,
  "originalName": "certificate_of_registration.pdf"
}

Error Response

Response Description

Parameter	Description
error	`object` The error details.

ResponseError.error

Field	Description
type	`string` Error code or type.
message	`string` Human-readable error message.

ResponseError.error.type

Value	Description	HTTP Status Code
parameter_error	Parameter validation failed (e.g., missing or invalid parameter).	400 Bad Request
iam_failed	Authentication or authorization failed.	401 Unauthorized
error	Internal server error or unknown error.	500 Internal Server Error
not_found	Requested resource not found.	404 Not Found
service_busy	The service is busy or rate limited.	429 Too Many Requests

Response Examples

{
  "error": {
    "type": "parameter_error",
    "message": "File type is required."
  }
}

{
  "error": {
    "type": "parameter_error",
    "message": "Unsupported file type. Supported types: PDF, JPEG, PNG, DOC, DOCX, XLS, XLSX, CSV"
  }
}

{
  "error": {
    "type": "parameter_error",
    "message": "File size exceeds the maximum limit of 10MB"
  }
}

Updated about 11 hours ago