Delete a Business Document
Removes a business document, which frees its type for a different file. Deleting one that is already gone answers 404. Documents are locked once the record is in_review, approved or rejected.
Takes a workspace-scoped API key or a dashboard session. An account-scoped key is refused with 401.
Replaces DELETE /api/v2/kyb/banking-verification/business/{accountId}/documents/{documentType}.
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
/v3/customers/{customer_id}/kyb/documents/{document_id}
Path parameters
| Parameter | Type | Description |
|---|---|---|
customer_id | string (cst_…) | Required. The business customer. |
document_id | string (doc_…) | Required. The document, from List Business Documents. |
Response
204 No Content, with no body.
Errors
| Status | message | When |
|---|---|---|
400 | failed to parse request | customer_id or document_id is not a TypeID of its kind. |
401 | unauthorized | Missing or invalid signature, or an account-scoped key or customer session. |
403 | forbidden | A dashboard member whose role does not allow this. A workspace-scoped key always may. |
404 | customer_not_found | No such customer in the workspace. |
404 | kyb_not_found | This customer has no record. |
404 | document_not_found | No such document on this record, or it was already deleted. |
409 | kyb_verification_in_flight | The record is in_review. |
409 | kyb_already_approved | The record is approved. |
409 | kyb_rejected | The record is rejected. |
Coming from v2
v2 (DELETE …/business/{accountId}/documents/{documentType}) | v3 |
|---|---|
accountId (path, uuid) | customer_id (path, cst_…) |
| names the document by its type | names it by its document_id (doc_…) |
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!