GET
/
sessions
List all sessions
curl --request GET \
  --url https://backendapi.corbado.io/v2/sessions \
  --header 'Authorization: Basic <encoded-value>'
{
  "sessions": [
    {
      "sessionID": "V4Gy2mCXekKuvKwbG81ysvegY9dB01",
      "userID": "usr-4693224802260150919",
      "identifierValue": "jane@doe.com",
      "createdMs": 1752738240000,
      "lastActionMs": 1752738240000,
      "expiresMs": 1755330240000,
      "status": "active"
    }
  ],
  "paging": {
    "page": 1,
    "totalPages": 123,
    "totalItems": 123
  }
}

Authorizations

​
Authorization
string
header
required

Basic authentication is used to authenticate requests to the Backend API. The username is the project ID and the password is the API secret.

The project ID and API secret can be found in the Developer Panel.

Query Parameters

​
sort
string

Field and direction to sort results. Use the format fieldName:asc or fieldName:desc.

Example:

"createdAt:desc"

​
filter[]
string[]

Filter results by specific fields and conditions. Format: <field>:<operator>:<value>. Supported operators include:

  • eq: equals (e.g. email:eq:mail@example\.com matches items where email equals mail@example.com)
  • gt: greater than (e.g. created:gt:2021-01-01T00:00:00 matches items created after Jan 1, 2021)
  • lt: less than (e.g. created:lt:2021-01-01T00:00:00 matches items created before Jan 1, 2021)
​
page
integer
default:1

The page number to retrieve for paginated results.

Example:

1

​
pageSize
integer
default:10

The number of items to return per page. Useful for pagination.

Example:

20

Response

200
application/json

List of all matching sessions.

The response is of type object.