Download Document

Request

https://openapi.advance.ai/v1/business/documents/{documentId}
GET

Request Header Parameters

Parameter	Description
Authorization	`string` Please use Token Authentication API to get your access token. Format: `Bearer {token}`

Path Parameters

Parameter	Required	Description
documentId	True	`string` The unique identifier of the document to download.

Request Examples

curl -X GET "https://openapi.advance.ai/v1/business/documents/DOC-2026052200001" \
-H "Authorization: Bearer {Your Access Token}"

Success Response

Response Description

Field	Description
documentId	`string` The unique identifier of the document.
originalName	`string` The original filename of the document.
documentFormat	`string` The format of the file (PDF, JPEG, PNG, etc.).
documentType	`enum` The type of document.
documentUrl	`string` The pre-signed URL to download the document. This URL is temporary and will expire.

DocumentTypeEnum - Company Documents

Value	Description
CERTIFICATE_OF_REGISTRATION	Certificate of incorporation/registration
MEMORANDUM_O_REGISTRATION	Memorandum of incorporation/association/registration
RECENT_EXCERPT	Recent excerpt from a state company registry
STATEMENT_OF_INFORMATION	Statement of information
PROOF_OF_ADDRESS	Proof of address
CERTIFICATE_OF_INCUMBENCY	Certificate of incumbency
CERTIFICATE_OF_GOOD_STANDING	Certificate of good standing
SHAREHOLDER_REGISTRY	Shareholder registry
DIRECTOR_REGISTRY	Director registry
TRUST_AGREEMENT	Trust agreement
POWER_OF_ATTORNEY	Power of attorney
COMPANY_OTHERS	Company other documents

DocumentTypeEnum - Individual Documents

Value	Description
PASSPORT	Passport
ID_CARD	ID card
DRIVERS_LICENSE	Driver's license
RESIDENCE_PERMIT	Residence permit
INDIVIDUAL_OTHERS	Individual other documents

Response Examples

{
  "documentId": "DOC-2026052200001",
  "originalName": "certificate_of_registration.pdf",
  "documentFormat": "PDF",
  "documentType": "CERTIFICATE_OF_REGISTRATION",
  "documentUrl": "https://storage.example.com/documents/2026/05/22/DOC-2026052200001/certificate_of_registration.pdf?signature=abc123&expires=1716400800"
}

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": "The document was not found. Only application documents support downloading."
  }
}

Notes

URL Expiration: The documentUrl returned is a pre-signed URL that will expire after a short period. Download the document promptly after receiving the URL.
Access Control: Only documents that belong to applications within your workspace can be downloaded.
Document Availability: Only documents that have been attached to an application via the Add Application Document endpoint are available for download. Newly uploaded documents that haven't been attached will return a "not found" error.