curl --request GET \
--url https://verification.didit.me/v3/users/ \
--header 'x-api-key: <api-key>'{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"vendor_data": "user-abc-123",
"display_name": null,
"full_name": "John Michael Doe",
"date_of_birth": "1990-05-15",
"effective_name": "John Michael Doe",
"status": "Approved",
"portrait_image_url": "https://service-didit-verification.s3.amazonaws.com/...",
"session_count": 3,
"approved_count": 2,
"declined_count": 0,
"in_review_count": 1,
"issuing_states": {
"USA": 2
},
"approved_emails": {
"john@example.com": true
},
"approved_phones": {
"+14155551234": true
},
"features": {
"OCR": "Approved",
"LIVENESS": "Approved",
"FACE_MATCH": "Approved",
"AML": "Approved"
},
"features_list": [
{
"feature": "OCR",
"status": "Approved"
},
{
"feature": "LIVENESS",
"status": "Approved"
},
{
"feature": "FACE_MATCH",
"status": "Approved"
},
{
"feature": "AML",
"status": "Approved"
}
],
"last_session_at": "2025-06-15T10:30:00Z",
"first_session_at": "2025-06-01T08:00:00Z",
"tags": [
{
"uuid": "t1111111-2222-3333-4444-555555555555",
"name": "VIP",
"color": "#2567FF"
}
],
"created_at": "2025-06-01T08:00:00Z"
},
{
"vendor_data": "user-xyz-456",
"display_name": "Jane S.",
"full_name": "Jane Elizabeth Smith",
"date_of_birth": "1985-11-22",
"effective_name": "Jane S.",
"status": "In Review",
"portrait_image_url": null,
"session_count": 1,
"approved_count": 0,
"declined_count": 0,
"in_review_count": 1,
"issuing_states": {},
"approved_emails": {},
"approved_phones": {},
"features": {
"OCR": "In Review"
},
"features_list": [
{
"feature": "OCR",
"status": "In Review"
}
],
"last_session_at": "2025-06-20T14:00:00Z",
"first_session_at": "2025-06-20T14:00:00Z",
"tags": [],
"created_at": "2025-06-20T14:00:00Z"
}
]
}List all verified users for your application. Each user is identified by the vendor_data string you provided when creating their session.
curl --request GET \
--url https://verification.didit.me/v3/users/ \
--header 'x-api-key: <api-key>'{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"vendor_data": "user-abc-123",
"display_name": null,
"full_name": "John Michael Doe",
"date_of_birth": "1990-05-15",
"effective_name": "John Michael Doe",
"status": "Approved",
"portrait_image_url": "https://service-didit-verification.s3.amazonaws.com/...",
"session_count": 3,
"approved_count": 2,
"declined_count": 0,
"in_review_count": 1,
"issuing_states": {
"USA": 2
},
"approved_emails": {
"john@example.com": true
},
"approved_phones": {
"+14155551234": true
},
"features": {
"OCR": "Approved",
"LIVENESS": "Approved",
"FACE_MATCH": "Approved",
"AML": "Approved"
},
"features_list": [
{
"feature": "OCR",
"status": "Approved"
},
{
"feature": "LIVENESS",
"status": "Approved"
},
{
"feature": "FACE_MATCH",
"status": "Approved"
},
{
"feature": "AML",
"status": "Approved"
}
],
"last_session_at": "2025-06-15T10:30:00Z",
"first_session_at": "2025-06-01T08:00:00Z",
"tags": [
{
"uuid": "t1111111-2222-3333-4444-555555555555",
"name": "VIP",
"color": "#2567FF"
}
],
"created_at": "2025-06-01T08:00:00Z"
},
{
"vendor_data": "user-xyz-456",
"display_name": "Jane S.",
"full_name": "Jane Elizabeth Smith",
"date_of_birth": "1985-11-22",
"effective_name": "Jane S.",
"status": "In Review",
"portrait_image_url": null,
"session_count": 1,
"approved_count": 0,
"declined_count": 0,
"in_review_count": 1,
"issuing_states": {},
"approved_emails": {},
"approved_phones": {},
"features": {
"OCR": "In Review"
},
"features_list": [
{
"feature": "OCR",
"status": "In Review"
}
],
"last_session_at": "2025-06-20T14:00:00Z",
"first_session_at": "2025-06-20T14:00:00Z",
"tags": [],
"created_at": "2025-06-20T14:00:00Z"
}
]
}Filter by overall user status
Approved, Declined, In Review, Pending Search by name, vendor_data, email, or phone number
Filter by issuing country (ISO3 code)
Results per page (max 200)
Pagination offset