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

# List Sessions

`GET /v1/sessions`

List Sessions.

## Query parameters

- `userId` string
- `pageToken` string

## Response `200`

OK

- ListSessionsResponse
  - `sessions` Session[] — A list of Sessions.
    - `id` string — The Session ID. Starts with `session_...`.
    - `userId` string — The User this Session belongs to.
    - `revoked` boolean — Whether the Session is revoked.
    - `createTime` string, date-time — When the Session was created.
    - `lastActiveTime` string, date-time — When the Session was last active.
    - `expireTime` string, date-time — When the Session expires.
    - `primaryAuthFactor` integer — The primary authentication factor the end user used to log in.
  - `nextPageToken` string — The pagination token for the next page of results. Empty if there is no next page.

## Other responses

- `400` — API Error
- `401` — API Error
- `403` — API Error
- `404` — API Error

## Changes

- **2025-04-04** `513710f96a94` — 1 info
  - added the optional property `sessions/items/primaryAuthFactor` to the response with the `200` status
- **2025-03-05** `aae16339e1e1` — 4 breaking, 8 warning
  - the `details/items/` response's property type changed from `object` to no type for status `400`
  - the `details/items/` response's property type changed from `object` to no type for status `401`
  - the `details/items/` response's property type changed from `object` to no type for status `403`
  - the `details/items/` response's property type changed from `object` to no type for status `404`
  - …8 more
- **2025-03-04** `b9fc18a0eac3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tesseral-labs/apis/backendservice-api/changes/v1/sessions/get.md)

---

[API](https://skmtc.dev/tesseral-labs/apis/backendservice-api.md) · [All operations](https://skmtc.dev/tesseral-labs/apis/backendservice-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tesseral-labs/backendservice-api/revisions/fe83f78ae20a/schema)