List Sessions

GET/v1/agents/sessions

List Sessions in your organization with cursor pagination. Rows that cannot be read live still appear, with a failure such as session_not_ready or session_snapshot_unavailable.

Query parameters

Optional<string>lifecycle_status

active, archived, or all.

Default: active

Optional<string>agent_id

Only Sessions of this Agent.

Optional<integer>limit

Page size from 1 to 100. Values outside the range return 400.

Default: 20

Optional<string>after

Cursor. Pass last_id from the previous page.

Optional<string>order

asc or desc by creation time.

Default: desc

curl -X GET "https://api.sandbase.ai/v1/agents/sessions?agent_id=agt_8c1f2b9e-3d4a-4f6b-9c2e-1a7d5e3b4c60&limit=20" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "object": "list",
  "data": [
    {
      "id": "ses_5b0e7c3a-91d2-5f4e-8a6b-2c9d4e1f7a83",
      "object": "agent.session",
      "agent": {
        "id": "agt_8c1f2b9e-3d4a-4f6b-9c2e-1a7d5e3b4c60",
        "name": "Research assistant",
        "model": "deepseek/deepseek-v4-flash",
        "instructions": "Answer with cited sources.",
        "multi_agent": {
          "enabled": false,
          "max_concurrent_subagents": null
        },
        "reasoning": {
          "effort": null,
          "summary": null
        },
        "service_tier": "auto",
        "text": {
          "format": {
            "type": "text"
          },
          "verbosity": "medium"
        },
        "tools": []
      },
      "agent_id": "agt_8c1f2b9e-3d4a-4f6b-9c2e-1a7d5e3b4c60",
      "agent_version": 1,
      "title": "Market scan",
      "model": "deepseek/deepseek-v4-flash",
      "environment": {
        "id": "env_…",
        "type": "openai_hosted",
        "capability_directories": [],
        "files": [],
        "network": {
          "access": "enabled",
          "allowed_domains": []
        },
        "packages": {
          "npm": [],
          "python": [],
          "system": []
        },
        "plugins": [],
        "skills": []
      },
      "metadata": {},
      "status": "idle",
      "lifecycle_status": "active",
      "sync_status": "ready",
      "execution_status": "idle",
      "failure": null,
      "row_version": 1,
      "required_actions": [],
      "vault_ids": [],
      "usage": null,
      "created_at": 1791273600,
      "last_active_at": 1791273600,
      "updated_at": 1791273600,
      "archived_at": null,
      "source": "direct",
      "source_id": null
    }
  ],
  "has_more": false,
  "first_id": "ses_5b0e7c3a-91d2-5f4e-8a6b-2c9d4e1f7a83",
  "last_id": "ses_5b0e7c3a-91d2-5f4e-8a6b-2c9d4e1f7a83"
}