Get Session

GET/v1/sessions/{session_id}

Retrieve a session by ID, including current status and agent reference.

Path parameters

stringsession_idrequired

The session ID (sess...)

from anthropic import Anthropic

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

session = client.beta.sessions.retrieve(
    session_id="sess_01abc..."
)
print(f"Status: {session.status}")

Response200 OK

{
  "id": "sess_01abc...",
  "type": "session",
  "status": "idle",
  "title": "Research task",
  "agent_id": "agent_01HqR2k7...",
  "agent_version": 1,
  "environment_id": "env_01abc...",
  "metadata": { "user_id": "usr_123", "task": "research" },
  "archived_at": null,
  "created_at": "2026-05-29T10:00:00Z",
  "updated_at": "2026-05-29T10:05:00Z"
}