Retrieves a single KYB document by ID. The customer must be of type business and the document must belong to the supplied customer. Required scope: customer:read.
Authorization
oauth2ClientCredentials customer:readUse your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.
In: header
Scope: customer:read
Path Parameters
uuiduuidResponse Body
application/json
curl --request GET \ --url 'https://example.com/api/external/customer/497f6eca-6276-4993-bfeb-53cbbbba6f08/document/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "message": "Document retrieved 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": "APPROVED", "admin_comments": null, "url": "https://s3.amazonaws.com/...?X-Amz-Signature=...", "created_at": "2026-04-20T10:14:31.000000Z", "updated_at": "2026-04-22T08:01:12.000000Z" }}GETList customer KYB documents
Returns every KYB document the business has registered for this customer. Each row's `url` is a 2-minute presigned link to the underlying file. The customer must be of type `business`. Required scope: `customer:read`.
POSTGet a KYB document upload URL
Two-step upload, step one. Returns a `file_id`, a presigned `url`, and the headers required to PUT the file directly to S3. The URL is valid for 5 minutes and accepts a single PUT. Step two: call `POST /api/external/customer/{customer}/document` with the same `file_id` to register the document. Max file size 25 MB. Allowed types: `application/pdf`, `image/jpeg`, `image/png`. Files outside these limits are rejected at registration time. The customer must be of type `business`. Individual customers do not use this endpoint — they use the legacy file flow (`POST /api/external/file/get-presigned-url` followed by `POST /api/external/customer/{id}/files`). Required scope: `customer:write`.