Cancel Verification

Cancel a pending or in-progress verification request. Completed verifications cannot be cancelled.

Cancel Verification

DELETE/verify?verification_id={id}

Query Parameters

ParameterTypeRequiredDescription
verification_idstringYesThe ID of the verification to cancel

Note

Only verifications with pending or in_progress status can be cancelled. Attempting to cancel a completed verification will return a 400 error.

Example Request

curl -X DELETE "https://tenantverify.org/api/v1/verify?verification_id=abc123" \
  -H "Authorization: Bearer tv_live_your_api_key"

Response (200 OK)

{
  "success": true,
  "message": "Verification cancelled successfully",
  "data": {
    "verification_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "cancelled"
  }
}
← Get UsageWebhooks →