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"
  }
}

KYB documents (business customers)

Register a KYB document

Use after PUTting a file to the presigned URL. The server verifies that the upload exists, checks size and MIME, and stores the document with status PENDING.

Max file size 25 MB. Allowed MIME: application/pdf, image/jpeg, image/png. Files that fail these checks return 422.

Formation documents are required for verification. When you call POST /api/external/customer/{customer}/submit, at least one document of a formation type must be present. Formation types are: CERTIFICATE_OF_INCORPORATION, ARTICLES_OF_INCORPORATION, BENEFICIAL_OWNERSHIP_CERTIFICATE, INCORPORATION_DOCUMENTS, CAC_STATUS_REPORT. Other types may be required by your compliance reviewer depending on the business profile.

All uploaded documents must be clear, legible, and authentic. Blurry, cropped, obscured, or otherwise unclear images will be rejected. Fraudulent or falsified documents will not be tolerated — repeated attempts to submit false or invalid documents will result in the customer being permanently blacklisted from the platform. There are no exceptions or compromises.

The customer must be of type business. Required scope: customer:write.

POST

api

external

customer

{customer}

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"
  }
}

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.

Get a KYB document upload URL Update a KYB document

⌘I