curl

curl -s 'https://verification.didit.me/v3/sessions/8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d/reviews/?limit=50' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "de0561bc-5583-4409-9171-1a31a4c8a5f4",
      "activity_type": "STATUS_UPDATED",
      "actor_display": "API Client",
      "actor_email": null,
      "actor_type": "API_KEY",
      "new_status": "Approved",
      "previous_status": "In Review",
      "comment": "Document re-checked manually; address matches.",
      "mentioned_emails": [],
      "previous_value": {
        "status": "In Review"
      },
      "new_value": {
        "status": "Approved"
      },
      "changed_fields": [
        "status"
      ],
      "metadata": null,
      "created_at": "2026-06-12T00:19:31.918735Z"
    },
    {
      "uuid": "35370f58-5098-44ee-8a06-8c9af80b2455",
      "activity_type": "STATUS_UPDATED",
      "actor_display": "Unknown",
      "actor_email": null,
      "actor_type": "CONSOLE_USER",
      "new_status": null,
      "previous_status": null,
      "comment": "Note without status.",
      "mentioned_emails": [],
      "previous_value": null,
      "new_value": null,
      "changed_fields": [],
      "metadata": null,
      "created_at": "2026-06-12T00:18:44.504157Z"
    },
    {
      "uuid": "00338f82-f1c5-4f57-8614-c49bb258af1a",
      "activity_type": "STATUS_UPDATED",
      "actor_display": "Unknown",
      "actor_email": null,
      "actor_type": "CONSOLE_USER",
      "new_status": "In Review",
      "previous_status": null,
      "comment": "Flagging for manual document re-check.",
      "mentioned_emails": [],
      "previous_value": null,
      "new_value": null,
      "changed_fields": [],
      "metadata": null,
      "created_at": "2026-06-12T00:18:44.466537Z"
    }
  ]
}

Session Operations

List Session Reviews

Return the audit trail / activity feed for a User Verification (KYC) session, newest first, in a paginated envelope (count / next / previous / results, 50 entries per page by default).

Feed entries are written by every actor that touches the session: manual decisions made through PATCH /v3/session/{session_id}/update-status/ (which records previous_status → new_status), Console reviewer activity (comments with @email mentions, KYC/POA data edits, file uploads/removals, tag changes, detail-page views), AML ongoing-monitoring matches, and notes appended via POST on this same path. Reading this feed is the API-side equivalent of the Activity panel in the Didit Console session view.

Only User Verification (KYC) sessions are addressable here; Business Verification (KYB) session IDs return 404.

GET

sessions

{session_id}

reviews

curl

curl -s 'https://verification.didit.me/v3/sessions/8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d/reviews/?limit=50' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "de0561bc-5583-4409-9171-1a31a4c8a5f4",
      "activity_type": "STATUS_UPDATED",
      "actor_display": "API Client",
      "actor_email": null,
      "actor_type": "API_KEY",
      "new_status": "Approved",
      "previous_status": "In Review",
      "comment": "Document re-checked manually; address matches.",
      "mentioned_emails": [],
      "previous_value": {
        "status": "In Review"
      },
      "new_value": {
        "status": "Approved"
      },
      "changed_fields": [
        "status"
      ],
      "metadata": null,
      "created_at": "2026-06-12T00:19:31.918735Z"
    },
    {
      "uuid": "35370f58-5098-44ee-8a06-8c9af80b2455",
      "activity_type": "STATUS_UPDATED",
      "actor_display": "Unknown",
      "actor_email": null,
      "actor_type": "CONSOLE_USER",
      "new_status": null,
      "previous_status": null,
      "comment": "Note without status.",
      "mentioned_emails": [],
      "previous_value": null,
      "new_value": null,
      "changed_fields": [],
      "metadata": null,
      "created_at": "2026-06-12T00:18:44.504157Z"
    },
    {
      "uuid": "00338f82-f1c5-4f57-8614-c49bb258af1a",
      "activity_type": "STATUS_UPDATED",
      "actor_display": "Unknown",
      "actor_email": null,
      "actor_type": "CONSOLE_USER",
      "new_status": "In Review",
      "previous_status": null,
      "comment": "Flagging for manual document re-check.",
      "mentioned_emails": [],
      "previous_value": null,
      "new_value": null,
      "changed_fields": [],
      "metadata": null,
      "created_at": "2026-06-12T00:18:44.466537Z"
    }
  ]
}

Authorizations

x-api-key

string

header

required

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

string | null

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

Example:

null

string | null

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

Example:

null

results

object[]

Feed entries for this page.

Show child attributes

Batch Delete Sessions Create Session Review

⌘I