Add Application Document

Attaches a previously uploaded document to a declared entity (company or individual) within an application. The document must be uploaded first using the Upload Document endpoint to obtain a document ID.

Request

https://openapi.advance.ai/v1/business/applications/{applicationId}/documents
PATCH (application/json)

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
applicationId	True	`string` The unique identifier of the application.

Request Parameters

Parameter	Required	Description
documentId	True	`string` The document ID obtained from the Upload Document endpoint.
declaredId	True	`string` The declared KYB company ID or KYB individual ID to attach the document to.

Request Examples

curl -X PATCH "https://openapi.advance.ai/v1/business/applications/APP-2026052200001/documents" \
-H "Authorization: Bearer {Your Access Token}" \
-H "Content-Type: application/json" \
-d '{
  "documentId": "DOC-2026052200001",
  "declaredId": "COM-2026052200001"
}'

curl -X PATCH "https://openapi.advance.ai/v1/business/applications/APP-2026052200001/documents" \
-H "Authorization: Bearer {Your Access Token}" \
-H "Content-Type: application/json" \
-d '{
  "documentId": "DOC-2026052200002",
  "declaredId": "IND-2026052200001"
}'

Success Response

Response Description

Field	Description
applicationId	`string` The unique identifier of the application.
declaredId	`string` The declared entity identifier the document was attached to.
entityType	`enum` The type of entity (COMPANY or INDIVIDUAL).
documentId	`string` The document identifier.
updatedAt	`string` The update timestamp in ISO 8601 format.

EntityTypeEnum

Value	Description
COMPANY	The document is attached to a company entity.
INDIVIDUAL	The document is attached to an individual entity.

Response Examples

{
  "applicationId": "APP-2026052200001",
  "declaredId": "COM-2026052200001",
  "entityType": "COMPANY",
  "documentId": "DOC-2026052200001",
  "updatedAt": "2026-05-22T11:00:00Z"
}

{
  "applicationId": "APP-2026052200001",
  "declaredId": "IND-2026052200001",
  "entityType": "INDIVIDUAL",
  "documentId": "DOC-2026052200002",
  "updatedAt": "2026-05-22T11:05:00Z"
}

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": "documentId cannot be empty"
  }
}

{
  "error": {
    "type": "not_found",
    "message": "Document not found"
  }
}

Updated about 11 hours ago