List Sessions

Lists Sessions in the selected Workspace, ordered newest-first by created_at unless order=asc. Filter with agent_id; agent_version applies only when agent_id is also supplied. Additional filters are the four exclusive or inclusive created_at bounds, memory_store_id (Sessions whose Resources include that MemoryStore), automation_id (Checkfu’s sole CMA noun substitution for deployment_id), repeated statuses, and include_archived; archived Sessions are excluded by default. Returns a bidirectional page with data, next_page, and prev_page; resend either non-null cursor as page.

Checkfu support posture: alpha; hosted. Required evidence journey: session-turn. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities.

GET /v1/sessions

List Sessions

cURL

curl --request GET \
  --url https://api.checkfu.com/v1/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'checkfu-beta: <checkfu-beta>' \
  --header 'checkfu-version: <checkfu-version>'

200

{
  "data": [
    {
      "id": "<string>",
      "agent": {
        "id": "<string>",
        "description": "<string>",
        "mcp_servers": [
          {
            "type": "url",
            "name": "<string>",
            "url": "<string>"
          }
        ],
        "model": {
          "id": "<string>",
          "effort": {
            "type": "low"
          },
          "inference_geo": "global",
          "speed": "standard"
        },
        "name": "<string>",
        "skills": [
          {
            "type": "anthropic",
            "skill_id": "<string>",
            "version": "<string>"
          }
        ],
        "system": "<string>",
        "tools": [
          {
            "type": "agent_toolset_20260401",
            "configs": [
              {
                "name": "bash",
                "type": "bash",
                "enabled": true,
                "permission_policy": {
                  "type": "always_allow"
                }
              }
            ],
            "default_config": {
              "enabled": true,
              "permission_policy": {
                "type": "always_allow"
              }
            }
          }
        ],
        "multiagent": {
          "agents": [
            {
              "id": "<string>",
              "description": "<string>",
              "mcp_servers": [
                {
                  "type": "url",
                  "name": "<string>",
                  "url": "<string>"
                }
              ],
              "model": {
                "id": "<string>",
                "effort": {
                  "type": "low"
                },
                "inference_geo": "global",
                "speed": "standard"
              },
              "name": "<string>",
              "skills": [
                {
                  "type": "anthropic",
                  "skill_id": "<string>",
                  "version": "<string>"
                }
              ],
              "system": "<string>",
              "tools": [
                {
                  "type": "agent_toolset_20260401",
                  "configs": [
                    {
                      "name": "bash",
                      "type": "bash",
                      "enabled": true,
                      "permission_policy": {
                        "type": "always_allow"
                      }
                    }
                  ],
                  "default_config": {
                    "enabled": true,
                    "permission_policy": {
                      "type": "always_allow"
                    }
                  }
                }
              ],
              "type": "agent",
              "version": 1
            }
          ],
          "type": "coordinator"
        },
        "type": "agent",
        "version": 1
      },
      "archived_at": "<string>",
      "budget": {
        "type": "limit",
        "max_list_cost": {
          "amount": "<string>",
          "currency": "USD"
        }
      },
      "created_at": "<string>",
      "environment_id": "<string>",
      "metadata": {},
      "outcome_evaluations": [
        {
          "completed_at": "<string>",
          "description": "<string>",
          "explanation": "<string>",
          "iteration": 1,
          "outcome_id": "<string>",
          "result": "<string>",
          "type": "outcome_evaluation"
        }
      ],
      "resources": [
        {
          "id": "<string>",
          "created_at": "<string>",
          "updated_at": "<string>",
          "mount_path": "<string>",
          "type": "github_repository",
          "url": "<string>",
          "checkout": {
            "type": "branch",
            "name": "<string>"
          }
        }
      ],
      "stats": {
        "active_seconds": 1,
        "duration_seconds": 1
      },
      "status": "rescheduling",
      "title": "<string>",
      "type": "session",
      "updated_at": "<string>",
      "usage": {
        "active_seconds": 1,
        "cache_creation": {
          "ephemeral_1h_input_tokens": 1,
          "ephemeral_5m_input_tokens": 1
        },
        "cache_read_input_tokens": 1,
        "input_tokens": 1,
        "list_cost": {
          "amount": "<string>",
          "currency": "USD"
        },
        "output_tokens": 1,
        "server_tool_use": {
          "web_fetch_requests": 1,
          "web_search_requests": 1
        }
      },
      "vault_ids": [
        "<string>"
      ],
      "automation_id": "<string>"
    }
  ],
  "next_page": "<string>",
  "prev_page": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version · enum<string> · required

Available options: 2026-08-27

checkfu-beta · string · required

Query Parameters

limit · integer

Required range: x >= 1

page · string

Pattern: ^c1_[0-9a-z]+$

agent_id · string

Pattern: ^agent_[0-9a-f]{32}$

agent_version · integer

Required range: x >= 1

created_at[gt] · string

created_at[gte] · string

created_at[lt] · string

created_at[lte] · string

memory_store_id · string

Pattern: ^memstore_[0-9a-f]{32}$

automation_id · string

Pattern: ^auto_[0-9a-f]{32}$

include_archived · boolean

order · enum<string>

Available options: asc, desc

statuses · enum<string>[]

Available options: rescheduling, running, idle, terminated

Response

200

application/json

BetaManagedAgentsSessionPage

data · object[] · required

Show child attributes

next_page · string | null · required

prev_page · string | null · required