Get Identity Verification

curl -X GET https://sandbox.dhmad.tn/api/v1/identity-verifications/6655abc1234567890abcdef12 \
  -H "Authorization: Bearer sk_sandbox_your_api_key_here"

const response = await fetch(
  'https://sandbox.dhmad.tn/api/v1/identity-verifications/6655abc1234567890abcdef12',
  {
    headers: {
      'Authorization': 'Bearer sk_sandbox_your_api_key_here'
    }
  }
);

const data = await response.json();

import requests

response = requests.get(
    'https://sandbox.dhmad.tn/api/v1/identity-verifications/6655abc1234567890abcdef12',
    headers={'Authorization': 'Bearer sk_sandbox_your_api_key_here'}
)

data = response.json()

{
  "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"
}

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"

const response = await fetch(
  'https://sandbox.dhmad.tn/api/v1/identity-verifications/6655abc1234567890abcdef12',
  {
    headers: {
      'Authorization': 'Bearer sk_sandbox_your_api_key_here'
    }
  }
);

const data = await response.json();

import requests

response = requests.get(
    'https://sandbox.dhmad.tn/api/v1/identity-verifications/6655abc1234567890abcdef12',
    headers={'Authorization': 'Bearer sk_sandbox_your_api_key_here'}
)

data = response.json()

{
  "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

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"
}

Get Started

API Reference

Guides

Developer Portal

Path Parameters

Response Fields

Error Responses

​Path Parameters

​Response Fields

​Error Responses

Path Parameters

Response Fields

Error Responses