# List Sessions

`GET /auth/sessions` · Identity & Access · Sign-in & 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

| Name | In | Required | Description |
|---|---|---|---|
| `projectSlug` | path | yes | The project's slug: the path segment after `@`. It is unique within the org. Example: `"storefront"`. |

## Responses

- **200**: Success

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | array of object | yes | The project's live end-user sessions, newest first, at most 200. |
| `data.[]id` | string | yes | The session's id. |
| `data.[]userId` | string | yes | The end user the session belongs to (`eu_...`). |
| `data.[]createdAt` | string (date-time) | yes | When the session started. |
| `data.[]idleAt` | string (date-time) | yes | When the session was last active. |
| `data.[]absoluteExpiresAt` | string (date-time) | yes | When the session ends however active it is. |
| `data.[]revokedAt` | object | yes | When the session was revoked. Null for every listed session, because only live sessions are listed. |
| _one of_ | | |  |
| _or_ | | |  |
| `data.[]geoCountry` | null | yes | Always null: the country of the address is not looked up. |
| `meta` | object | yes | Request metadata: cost, timing and the request and trace ids. |


## Errors

| HTTP | Code | When |
|---|---|---|
| 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. |

## Code samples

### cURL

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

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/auth/sessions', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`
  },
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/identity-access/list-sessions
