List Users
List users Didit assembles from KYC sessions sharing the same vendor_data (free-form string, NOT a UUID), plus users created via the API. Paginated, ordered by last_session_at desc. This endpoint does not support filtering or search parameters — fetch pages and filter client-side.
Overview
Returns a paginated list of User entities for the authenticated application. Use this to sync users to your warehouse, find users needing analyst attention, or search by display name.When to use it
- Periodic sync of your user table to an external BI or warehouse.
- Analyst queues — filter by
status=FLAGGEDor stalelast_activity_atto drive a review inbox. - Search users by
display_name,full_name, orvendor_data.
Filters and pagination
Notes
- Each response item includes
didit_internal_id.vendor_datamay benullwhen the original session or transaction did not provide one. - This endpoint paginates via cursor — persist the
nextcursor between calls and stop whennextis empty. - See the User data model for all fields on a user row.
Permissions
Role must grantlist:users. See Roles & permissions.
Related
Authorizations
Query Parameters
Page size. Defaults to 50 when omitted. There is no enforced maximum, but keep pages small for latency.
x >= 1Zero-based offset of the first record to return. Prefer following the next URL from the previous page over computing this by hand.
x >= 0Response
Paginated list of users with verification status, session counts, and feature breakdown.
Number of matching rows — exact up to 100, capped at 100 beyond that for performance. Do not use it to detect the last page; rely on next being null instead.
Absolute URL of the next page, or null on the last page.
Absolute URL of the previous page, or null on the first page.