Skip to main content
GET/auth/sessions

List Sessions

Returns a cursor-paginated list of active sessions for all users within the project.

Requires PROJECT_ADMIN.

Supports filters for userId, status, since, and until.

Each row includes session type, user identity, MFA verification timestamp, source IP, inferred geo-country, user-agent, and absolute expiry.

Parameters
projectSlug *path

The project's slug: the path segment after @.

It is unique within the org.

Responses
HTTPK9O CodeDescription
200Success
401K9O_MFA_REQUIREDMulti-factor authentication is required to complete this request.
403K9O_ACCESS_DENIEDYour account does not have the PROJECT_ADMIN role required to list all sessions in this project.
410K9O_SLUG_GONEThe project slug in the URL has been renamed; update your integration to use the new slug.
Response body (200)
data *object[]

The project's live end-user sessions, newest first, at most 200.

id *string

The session's id.

userId *string

The end user the session belongs to (eu_...).

createdAt *string <date-time>

When the session started.

idleAt *string <date-time>

When the session was last active.

absoluteExpiresAt *string <date-time>

When the session ends however active it is.

revokedAt *any

When the session was revoked.

Null for every listed session, because only live sessions are listed.

One of: string <date-time>
or: null
geoCountry *null

Always null: the country of the address is not looked up.

meta *any

Request metadata: cost, timing and the request and trace ids.

cURL
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/auth/sessions' \
  -H 'Authorization: Bearer $K9O_TOKEN'

Showing example in cURL

Response example (200)
{
  "data": [
    {
      "id": "string",
      "userId": "string",
      "createdAt": "string",
      "idleAt": "string",
      "absoluteExpiresAt": "string",
      "revokedAt": "string"
    }
  ]
}

More in Sign-in & Sessions