Skip to main content
GET
curl

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=FLAGGED or stale last_activity_at to drive a review inbox.
  • Search users by display_name, full_name, or vendor_data.

Filters and pagination

Notes

  • Each response item includes didit_internal_id. vendor_data may be null when the original session or transaction did not provide one.
  • This endpoint paginates via cursor — persist the next cursor between calls and stop when next is empty.
  • See the User data model for all fields on a user row.

Permissions

Role must grant list:users. See Roles & permissions.

Authorizations

x-api-key
string
header
required

Query Parameters

limit
integer
default:50

Page size. Defaults to 50 when omitted. There is no enforced maximum, but keep pages small for latency.

Required range: x >= 1
offset
integer
default:0

Zero-based offset of the first record to return. Prefer following the next URL from the previous page over computing this by hand.

Required range: x >= 0

Response

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

count
integer

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.

next
string | null

Absolute URL of the next page, or null on the last page.

previous
string | null

Absolute URL of the previous page, or null on the first page.

results
object[]