Skip to main content
GET
/
v3
/
users
List Users
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"
    }
  ]
}

Authorizations

x-api-key
string
header
required

Query Parameters

status
enum<string>

Filter by overall user status

Available options:
Approved,
Declined,
In Review,
Pending

Search by name, vendor_data, email, or phone number

country
string

Filter by issuing country (ISO3 code)

limit
integer
default:50

Results per page (max 200)

offset
integer
default:0

Pagination offset

Response

200 - application/json

Paginated list of users with verification status, session counts, and feature breakdown.

count
integer

Total number of users matching filters

next
string | null

URL of next page

previous
string | null

URL of previous page

results
object[]