Trash Verification

Moves a DOC Verify document to the trash. Documents in the trash can be restored or permanently deleted via API. Use this endpoint to soft-delete a verification document by its unique identifier.

HTTP Method and URL

DELETE {{host}}/api/v2/verifications/:uuid/trash?user_type=ENTERPRISE_API

Authentication Requirements

Requires a valid user token. Pass the token in the user-token header.

Path and Query Parameters

• :uuid (path): The unique identifier of the verification document. Use the variable {{verification_uuid}}.

• user_type (query): Must be set to ENTERPRISE_API.

Request Body

This request does not require a body.

Example Request

DELETE {{host}}/api/v2/verifications/{{verification_uuid}}/trash?user_type=ENTERPRISE_API
user-token: <your_token>

Example Successful Response

{
  "status": "success",
  "message": "Verification document moved to trash."
}

Error Responses

• 404 Not Found: Document with the specified UUID does not exist.

• 401 Unauthorized: Authentication token is missing or invalid.

• 400 Bad Request: Invalid parameters provided.

Usage Notes

• Documents in the trash can be restored or permanently deleted using other API endpoints.

• Ensure you have the correct permissions to perform this operation.