API ReferenceIdentities

List user sessions

List one user's sessions (newest first), cursor-paginated. Organization-wide; requires owner/admin. Identify by email OR user_id (exactly one). Returns identity_id, sessions, and cursor; pass cursor back to fetch the next page (null when no more).

GET
/identities/sessions
AuthorizationBearer <token>

Organization API Token (prefixed sk_) sent as Authorization: Bearer sk_.... Create one in Settings and grant it scopes. Server-side only.

In: header

Query Parameters

email?string

The user's email address. Provide exactly one of email or user_id.

Length1 <= length
user_id?string

The user_id as sent to Logspot via identify/track. Provide exactly one of email or user_id.

Length1 <= length
start_date?string

Inclusive start of the window (ISO-8601). Defaults to 30 days ago.

end_date?string

Inclusive end of the window (ISO-8601). Defaults to now.

limit?integer

Maximum sessions per page (1-100). Defaults to 50.

Range1 <= value <= 100
cursor?string

Opaque pagination cursor from a previous response.

Length1 <= length

Response Body

curl -X GET "https://api.logspot.io/v1/identities/sessions"
Empty
Empty
Empty
Empty
Empty