Skip to main content
GET
curl

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is missing, wrong, revoked or expired; 403 means the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Path Parameters

session_id
string<uuid>
required

UUID of the User Verification (KYC) session. Must belong to the same application as the API key — cross-application UUIDs, deleted sessions, and Business Verification (KYB) session IDs all return 404.

Example:

"8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d"

Query Parameters

limit
integer
default:50

Page size. Defaults to 50.

Example:

50

offset
integer
default:0

Number of entries to skip from the start of the (ordered) feed. Defaults to 0. The next / previous URLs in the response carry the right values for walking the feed.

Example:

0

ordering
string
default:-created_at

Sort order. The feed defaults to newest first (-created_at); pass created_at to read it oldest first. Unknown values are silently ignored (default order is used); other serializer field names are also accepted.

Example:

"created_at"

Response

Paginated activity feed, newest first by default. count is the total number of entries; next / previous are ready-made page URLs (null at the ends). A count of 0 with empty results means no activity has been recorded yet.

count
integer

Total number of feed entries for this session (across all pages).

Example:

3

next
string | null

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

Example:

null

previous
string | null

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

Example:

null

results
object[]

Feed entries for this page.