List identity sessions

GET

/identity-sessions

Returns a paginated list of sessions belonging to a given identity, ordered newest first. A session is created whenever an identity successfully authenticates and represents an active, terminated, or pending-MFA login on a device. Use the optional query parameters to filter by session status. Pagination is cursor-based: each response includes a cursor value that you pass in the next request to fetch the following page. When has_more is false, you have reached the end of the list.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

Sessions retrieved successfully. Returns a page of sessions and pagination metadata.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location '/identity-sessions?identity_id=01HQZR2BKPFQ8MXJVT3G7LWNA&cursor=01HQZR2BKPFQ8MXJVT3G7LWNE&limit=20&status=active' \
--header 'Authorization: Bearer <token>'

Response Example

200 - First page — more results available

{
    "message": "Sessions retrieved successfully",
    "status": "success",
    "data": [
        {
            "id": "01HQZR2BKPFQ8MXJVT3G7LWNE",
            "identity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
            "identity_auth_id": "01HQZR2BKPFQ8MXJVT3G7LWNB",
            "status": "active",
            "expires_at": 1754611200000,
            "network_meta": {
                "ip": "197.210.53.12",
                "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
            },
            "created": 1754524800000,
            "updated": 1754524800000
        }
    ],
    "meta": {
        "pagination": {
            "cursor": "01HQZR2BKPFQ8MXJVT3G7LWNE",
            "has_more": true
        }
    }
}

Modified at 2026-09-28 09:30:45

Forward a POST request to the Verification API

Complete the MFA step of a pending login session