List Chat Sessions

List the user's chat sessions, ordered most-recently-updated first, with pagination.

GET /chat-v1/sessions

NOTE

• Session summaries returned by this endpoint omit the messages array. Fetch a specific session with include_messages=true to retrieve full conversation history.

Request

https://premium.aiera.com/api/chat-v1/sessions?page=1&page_size=2

Response

{
  "data": [
    {
      "id": 2227,
      "title": "NVIDIA Price Targets Research",
      "title_status": "user",
      "status": "finding_sources",
      "active_message_id": null,
      "messages": null,
      "sources": null,
      "model_generation_params": null,
      "model_id": null,
      "user_id": 9846,
      "votes": null,
      "created_at": "2026-04-29T20:47:54Z",
      "updated_at": "2026-04-29T20:51:52Z"
    },
    {
      "id": 2088,
      "title": "summarize the latest nflx earnings call",
      "title_status": "user",
      "status": "active",
      "active_message_id": null,
      "messages": null,
      "sources": null,
      "model_generation_params": null,
      "model_id": null,
      "user_id": 9846,
      "votes": null,
      "created_at": "2026-04-28T13:12:21Z",
      "updated_at": "2026-04-28T13:13:44Z"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 2,
    "total_pages": 3,
    "total_count": 5,
    "has_next": true,
    "has_previous": false
  }
}

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/chat-v1/sessions?page=1&page_size=2' \
  --header 'X-API-Key: your-rest-api-key'

Python

import requests
requests.get(
    "https://premium.aiera.com/api/chat-v1/sessions",
    params={"page": 1, "page_size": 2},
    headers={"X-API-Key": "your-rest-api-key"},
)