---
title: "List all sessions"
method: GET
path: "/sessions"
tags: ["Sessions"]
---

# List all sessions

`GET /sessions`

Returns a list of sessions matching the provided criteria.
The sessions are returned sorted by creation date, with the newest sessions appearing first.

Note: This endpoint does not return all sessions that have ever existed. Old and inactive sessions are periodically cleaned up and will not be included in the results.

**Deprecation Notice (2024-01-01):** All parameters were initially considered optional, however
moving forward at least one of `client_id` or `user_id` parameters should be provided.

## Query parameters

- `client_id` string
- `user_id` string
- `status` 'abandoned' | 'active' | 'ended' | 'expired' | 'removed' | 'replaced' | 'revoked'
- `paginated` boolean
- `limit` integer
- `offset` integer

## Response `200`

Success

- Session[]
  - `object` 'session', required — String representing the object's type. Objects of the same type share the same value.
  - `id` string, required
  - `user_id` string, required
  - `client_id` string, required
  - `actor` object, nullable
  - `status` 'active' | 'revoked' | 'ended' | 'expired' | 'removed' | 'abandoned' | 'replaced' | 'pending', required
  - `last_active_organization_id` string, nullable
  - `last_active_at` integer, required
  - `latest_activity` SessionActivityResponse, nullable
    - `object` string, required
    - `id` string, required
    - `device_type` string
    - `is_mobile` boolean, required
    - `browser_name` string
    - `browser_version` string
    - `ip_address` string
    - `city` string
    - `country` string
  - `expire_at` integer, required — Unix timestamp of expiration.
  - `abandon_at` integer, required — Unix timestamp of abandonment.
  - `updated_at` integer, required — Unix timestamp of last update.
  - `created_at` integer, required — Unix timestamp of creation.
  - `tasks` SessionTask[], nullable
    - `key` string, required

## Other responses

- `400` — Request was not successful
- `401` — Authentication invalid
- `422` — Invalid request parameters

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/7d969765e49a/schema)