Upload Document
This endpoint is deprecated. Use POST /v3/customers/{customer_id}/kyb/documents/presign: the file goes straight to storage, and the upload is then confirmed with …/complete. It keeps working while integrations move; see Versioning.
This endpoint allows uploading a verification document for a business account.
Takes a workspace-scoped API key. An account-scoped key is refused with 403.
Authorization:
Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.
Headers:
Authorization: APIKey {SIGNED_JWT}
How to build and sign the JWT: Authentication.
Endpoint
/api/v2/kyb/banking-verification/business/upload-document
Content Type
multipart/form-data
Request Body Schema
| Field | Type | Description |
|---|---|---|
accountId | string (uuid) | Required. The account ID to upload the document for. |
documentType | string | Required. The document type (e.g., certificate_of_incorporation). |
file | binary | Required. The file to upload. |
Response Sample
{
"message": "Document uploaded successfully",
"documentType": "certificate_of_incorporation",
"size": 1234567
}
Response Schema
| Field | Type | Description |
|---|---|---|
message | string | Confirmation message. |
documentType | string | The type of document uploaded. |
size | integer | File size in bytes. |
Errors
| Status | Message | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid signature. |
403 | forbidden | The key is account-scoped. |
409 | kyb_verification_locked | The business verification is in review or approved, so its documents cannot change. |
Support and Resources
If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.
Stay Updated
Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:
- Instagram: BlockWyre Instagram
- Twitter: BlockWyre Twitter
- Facebook: BlockWyre Facebook
- LinkedIn: BlockWyre LinkedIn
We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!