Skip to main content

Delete Document

Deprecated

This endpoint is deprecated. Use DELETE /v3/customers/{customer_id}/kyb/documents/{document_id}, which names the document by its id. It keeps working while integrations move; see Versioning.

This endpoint deletes a previously uploaded 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

DELETE

/api/v2/kyb/banking-verification/business/{accountId}/documents/{documentType}

Path Parameters​

ParameterTypeDescription
accountIdstring (uuid)Required. The account ID.
documentTypestringRequired. The document type to delete (e.g., certificate_of_incorporation).

Response​

Returns HTTP 204 No Content on successful deletion.

Error Responses​

Status CodeDescription
400Bad Request - Invalid parameters.
401Unauthorized - Missing or invalid signature.
403Forbidden - The key is account-scoped: {"code":403,"message":"forbidden"}.
404Not Found - Document not found.
409kyb_verification_locked - The business verification is in review or approved, so its documents cannot change.
500Internal Server Error.

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:

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!