List Services

GET/v1/services

List definitions with offset pagination.

Query parameters

Optional<string>status

active, paused, archived, or all. Other values return 400.

Default: active

Optional<string>agent_id

Only definitions bound to this Agent.

Optional<integer>limit

Page size up to 100; values above 100 return 400, and 0 or non-numeric values fall back to 20.

Default: 20

Optional<integer>offset

Number of records to skip.

Default: 0

curl -X GET "https://api.sandbase.ai/v1/services?status=active&limit=20" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "data": [
    {
      "id": "svc_2d7a9e14-6b3c-5f8d-a1e2-4c6b8d0f3a95",
      "kind": "service",
      "name": "Weekly brief",
      "description": "",
      "agent_id": "agt_8c1f2b9e-3d4a-4f6b-9c2e-1a7d5e3b4c60",
      "agent_version": 3,
      "input": "Summarize this week in AI agents.",
      "status": "active",
      "row_version": 1,
      "created_at": "2026-10-06T08:00:00Z",
      "updated_at": "2026-10-06T08:00:00Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}