List Sessions

GET/v1/sessions

List Agent Sessions for your organization with filtering and cursor pagination.

Query parameters

Optional<string>agent_id

Filter Sessions created with this Agent ID

Optional<integer>agent_version

Filter by Agent version. Only applies when agent_id is also set.

Optional<boolean>include_archived

Include archived Sessions. Default false.

Optional<string>created_at[gte]

Only Sessions created at or after this RFC 3339 time.

Optional<string>created_at[lte]

Only Sessions created at or before this RFC 3339 time.

Optional<integer>limit

Page size. Default 20, max 100.

Optional<string>page

Opaque cursor from a previous response's next_page field.

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-YOUR_KEY",
    base_url="https://api.sandbase.ai"
)

page = client.beta.sessions.list(agent_id="agent_01HqR2k7...", limit=20)
for session in page.data:
    print(f"{session.id} — {session.status} — {session.title}")

Response200 OK

{
  "data": [
    {
      "id": "sess_01abc...",
      "type": "session",
      "status": "idle",
      "title": "Research task",
      "agent_id": "agent_01HqR2k7...",
      "agent_version": 1,
      "metadata": {},
      "archived_at": null,
      "created_at": "2026-05-29T10:00:00Z",
      "updated_at": "2026-05-29T10:02:00Z"
    }
  ],
  "next_page": "page_eyJjIjoiMjAyNi0wNS0yOVQxMDowMDowMFoiLCJpIjoic2Vzc18wMSJ9"
}