{
  "sessions": [
    {
      "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "pending",
      "created_at": "2023-11-07T05:31:56Z",
      "metadata": {}
    }
  ],
  "total": 123,
  "has_more": true
}

Sessions

List Sessions

List all sessions for a user with pagination and filtering.

Retrieve conversation sessions with support for filtering by status and custom metadata. Results are sorted by creation date (newest first).

custom_user_id: User identifier (required)
offset: Number of records to skip for pagination (default: 0)
limit: Maximum records to return (default: 50, max: 200)
status_filter: Filter by session status: pending, processing, processed, insufficient_balance
metadata_filter: Filter by session metadata (supports nested JSON matching)

Returns paginated list of sessions with total count and pagination info.

GET

api

users

{custom_user_id}

sessions

{
  "sessions": [
    {
      "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "pending",
      "created_at": "2023-11-07T05:31:56Z",
      "metadata": {}
    }
  ],
  "total": 123,
  "has_more": true
}

Headers

X-Recallr-Project-Id

string<uuid>

required

X-Recallr-Api-Key

string

required

Path Parameters

custom_user_id

string

required

Query Parameters

offset

integer

default:0

Required range: x >= 0

limit

integer

default:10

Required range: 1 <= x <= 100

metadata_filter

string | null

status_filter

enum<string>[] | null

Show child attributes

Response

Sessions listed successfully

sessions

SessionInfo · object[]

required

Show child attributes

total

integer

required

has_more

boolean

required

Get User Messages Create Session

⌘I

Users

Sessions

Merge Conflicts

List Sessions

Headers

Path Parameters

Query Parameters

Response