Skip to main content
Weavr API
Corporates

Upload a KYB supporting document for a corporate

POST/corporates/{corporateId}/kyb/documents

Use this when you already hold paperwork for a corporate — a registration certificate or a shareholder register, say — and want it attached to the corporate's KYB before verification starts.

It stores one document against the corporate identified by the corporateId path parameter and returns the reference it was stored under. Send one document per call, up to 10MB, as multipart/form-data. Oversized files are rejected with DOCUMENT_TOO_LARGE and unreadable ones with UNSUPPORTED_DOCUMENT_FORMAT.

Timing

This only works before verification starts. Once the corporate has begun its KYB journey the upload is rejected with KYB_ALREADY_STARTED, so upload what you hold before calling Start KYB for a corporate. NOT_SUPPORTED means the corporate's profile isn't configured to accept pre-populated KYB data.

Request

Available on
SandboxProductionMock server

Path parameters

Request body

*
multipart/form-data

Multipart form carrying a single KYB supporting document, up to 10MB.

{}
CorporateKybDocumentFormCorporateKybDocumentForm · object · 3 fields

Responses

201Created

Document accepted.

Headers
Body
application/json
{}
CorporateKybDocumentResponseCorporateKybDocumentResponse · object · 1 field
Response example
{  "reference": "string"}