/auth/sessionsList 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.
| projectSlug * | path | The project's slug: the path segment after It is unique within the org. |
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | Success | |
| 401 | K9O_MFA_REQUIRED | Multi-factor authentication is required to complete this request. |
| 403 | K9O_ACCESS_DENIED | Your account does not have the PROJECT_ADMIN role required to list all sessions in this project. |
| 410 | K9O_SLUG_GONE | The project slug in the URL has been renamed; update your integration to use the new slug. |
| 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 ( |
| 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 -X GET 'https://<org>.api-<region>.k9o.io/@storefront/auth/sessions' \
-H 'Authorization: Bearer $K9O_TOKEN'Showing example in cURL
{
"data": [
{
"id": "string",
"userId": "string",
"createdAt": "string",
"idleAt": "string",
"absoluteExpiresAt": "string",
"revokedAt": "string"
}
]
}