Get User
Fetch one user by vendor_data. Adds metadata, comments, and updated_at to the list view. Returns soft-deleted users too.
Overview
Returns a single User entity keyed byvendor_data. Responses include didit_internal_id — Didit’s stable internal identifier.
When to use it
- Lookup a user’s current verification state — the
featuresmap gives you the latest status of every feature in a single object. - Detail views in your own UI — pull the profile on demand before rendering.
- Risk scoring — combine session counters and
featuresto score each user on your side.
Notes
vendor_datain the URL is case-sensitive.- Returns
404if no user with thatvendor_dataexists in the application. - Aggregate counters (
session_count,approved_count,declined_count,in_review_count) update in real time as sessions complete. - See the User data model for every field.
Permissions
Role must grantread:users.
Related
Authorizations
Path Parameters
Your unique identifier for the user — a free-form string (NOT a UUID). This is the same value you passed as vendor_data when creating the session that first introduced this user. Matching is case-insensitive after Didit normalisation.
Response
Full user detail including metadata, comments/activity log, and aggregated session data.
Full user detail. Extends UserListItem with metadata, comments, and updated_at.
Didit's stable internal UUID for this user.
Your unique identifier for this user (passed when creating sessions). This can be null when no vendor identifier was supplied.
Custom display name set by you
Full name extracted from verified documents
Best available name: display_name if set, otherwise full_name
Overall verification status of this user
Approved, Declined, In Review, Pending Presigned URL of the user's portrait photo (expires after a few hours)
Total number of verification sessions for this user
Number of approved sessions
Number of declined sessions
Number of sessions in review
Map of ISO3 country codes from approved documents, e.g. {"USA": 2, "ESP": 1}
Verified email addresses, e.g. {"john@example.com": true}
Verified phone numbers
Map of feature name to latest status, e.g. {"OCR": "Approved", "LIVENESS": "Approved", "AML": "In Review"}
Same as features but as an array of {feature, status} objects
Timestamp of the most recent session
Timestamp of the first session
Tags assigned to this user
Custom metadata JSON you attached to this user
Activity log and comments for this user