Skip to main content
Retrieve the current status of an identity verification session you created. Only verifications owned by your developer account (via the API key) are accessible. 
curl -X GET https://sandbox.dhmad.tn/api/v1/identity-verifications/6655abc1234567890abcdef12 \
  -H "Authorization: Bearer sk_sandbox_your_api_key_here"

{
  "id": "6655abc1234567890abcdef12",
  "email": "seller@example.com",
  "external_user_id": "seller_42",
  "kyc_status": "approved",
  "didit_session_status": "completed",
  "needs_admin_review": false,
  "claim_status": "pending",
  "linked_user_id": null,
  "linked_at": null,
  "created_at": "2026-06-06T12:00:00.000Z",
  "updated_at": "2026-06-06T14:30:00.000Z",
  "expires_at": "2026-09-04T12:00:00.000Z",
  "verification_email_sent": true,
  "verification_email_sent_at": "2026-06-06T12:00:00.000Z"
}

​
Path Parameters

​
id
string
required
Verification ID returned from Create verification

​
Response Fields

verification_url is not returned. Use webhooks as the primary way to learn when status changes.

​
Error Responses

Invalid ID: 
{
  "error": "Bad Request",
  "message": "Invalid verification ID"
}
Not found: 
{
  "error": "Not Found",
  "message": "Verification not found"
}