Skip to main content
GET
/
v3
/
sessions
List Sessions
curl --request GET \
  --url https://verification.didit.me/v3/sessions \
  --header 'x-api-key: <api-key>'
{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "session_id": "5b3720ed-d429-42ef-b67f-37ea805f48ee",
      "session_number": 720,
      "session_url": "https://verify.didit.me/example",
      "portrait_image": "https://example.com/portrait",
      "document_type": "ID",
      "full_name": "Alejandro Rosas",
      "country": "ESP",
      "status": "Approved",
      "vendor_data": "user-1",
      "created_at": "2025-06-09T12:26:54.328364Z",
      "features": [
        {
          "feature": "ID_VERIFICATION",
          "status": "Approved"
        },
        {
          "feature": "LIVENESS",
          "status": "Approved"
        },
        {
          "feature": "FACE_MATCH",
          "status": "Approved"
        },
        {
          "feature": "IP_ANALYSIS",
          "status": "Approved"
        }
      ],
      "phone_number": {
        "number": "+14155552671",
        "is_verified": true
      },
      "email_address": {
        "email": "[email protected]",
        "is_verified": true
      }
    },
    {
      "session_id": "6c8f0c7a-e872-4a6d-9703-489b6a7e17ec",
      "session_number": 19,
      "session_url": "https://verify.didit.me/example",
      "portrait_image": "https://example.com/portrait",
      "document_type": "P",
      "full_name": "John Doe",
      "country": "USA",
      "status": "Declined",
      "vendor_data": "user-1",
      "created_at": "2025-06-09T08:02:23.343053Z",
      "features": [
        {
          "feature": "ID_VERIFICATION",
          "status": "Declined"
        },
        {
          "feature": "LIVENESS",
          "status": "Approved"
        },
        {
          "feature": "FACE_MATCH",
          "status": "Approved"
        },
        {
          "feature": "IP_ANALYSIS",
          "status": "Approved"
        }
      ],
      "phone_number": {
        "number": "+14155552671",
        "is_verified": true
      },
      "email_address": {
        "email": "[email protected]",
        "is_verified": true
      }
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
vendor_data
string
default:""

A unique identifier for the vendor or user, such as a UUID or email. This field enables proper session tracking and user data aggregation across multiple verification sessions.

​
country
string
default:""

ISO 3166-1 alpha-3 country code representing the country of the country of the applicant's ID document, which may differ from nationality. For example, GBR.

​
status
string
default:""

The status of the verification session. For a complete list of possible verification statuses, refer to the Verification Statuses page.

​
workflow_id
string
default:""

The identifier of the verification workflow to filter sessions by. You can find this ID on the Workflows page in the Console.

​
offset
string
default:0

The number of items to skip before starting to return results.

​
limit
string
default:20

The maximum number of items to return in the response.

Response

200 - application/json
​
count
integer
Example:

2

​
next
string
Example:

null

​
previous
string
Example:

null

​
results
object[]