Skip to main content
POST
/
api
/
external
/
customer
/
{customer}
/
document
Register a KYB document
curl --request POST \
  --url https://api-prod.blaaiz.com/api/external/customer/{customer}/document \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "CERTIFICATE_OF_INCORPORATION",
  "name": "Acme Inc — Certificate of Incorporation.pdf",
  "file_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "Filed 2019-03-12, Companies House"
}
'
{
  "message": "Document created successfully",
  "data": {
    "id": "019a6e10-1fb3-7b2f-8f8b-ad1e92c4017a",
    "business_customer_id": "019a6da3-4a9a-7033-81b9-12489eff13ee",
    "type": "CERTIFICATE_OF_INCORPORATION",
    "name": "Acme Inc — Certificate of Incorporation.pdf",
    "extension": "pdf",
    "description": "Filed 2019-03-12, Companies House",
    "status": "PENDING",
    "admin_comments": null,
    "url": "https://s3.amazonaws.com/...?X-Amz-Signature=...",
    "created_at": "2026-04-20T10:14:31.000000Z",
    "updated_at": "2026-04-20T10:14:31.000000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.business.blaaiz.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
customer
string<uuid>
required

Body

application/json
​
type
enum<string>
required

Document type. Determines whether the document satisfies the formation-document requirement at submit time.

Available options:
CERTIFICATE_OF_INCORPORATION,
ARTICLES_OF_INCORPORATION,
BENEFICIAL_OWNERSHIP_CERTIFICATE,
INCORPORATION_DOCUMENTS,
CAC_STATUS_REPORT,
ACCOUNT_AGREEMENT,
PROOF_OF_ADDRESS,
BANK_STATEMENT,
LICENSE,
SHARE_REGISTRATION,
COMPANY_OWNERSHIP_STRUCTURE,
DIRECTORS_REGISTER,
OTHER
Example:

"CERTIFICATE_OF_INCORPORATION"

​
name
string
required
Maximum string length: 255
Example:

"Acme Inc — Certificate of Incorporation.pdf"

​
file_id
string<uuid>
required

The file_id returned by POST /api/external/customer/{customer}/document/presigned-url.

​
description
string | null
Maximum string length: 2000
Example:

"Filed 2019-03-12, Companies House"

Response

Document registered.