DocsAPI ReferenceList bots
GET/api/v1/bots

Returns a list of bots in the workspace. Supports filtering by status, bot ID, meeting ID, and date range. Results are paginated — use `limit` and `offset` to page through large sets.

Query Parameters

limitintegere.g. 50

Max results per page. Range: 1–100. Default: 50.

offsetintegere.g. 0

Number of results to skip. Default: 0.

statusstringe.g. "completed"

Filter by status. One of: `requested`, `joining`, `awaiting_admission`, `active`, `stopping`, `completed`, `failed`, `scheduled`.

bot_idstringe.g. "550e8400-e29b-41d4-a716-446655440000"

Filter to a specific bot by UUID.

meeting_idstringe.g. "abc-defg-hij"

Filter by platform-specific meeting ID (e.g. `abc-defg-hij`).

qstringe.g. "Q3 Review"

Text search on meeting name (case-insensitive substring match).

date_fromstringe.g. "2026-05-01T00:00:00Z"

ISO 8601 datetime lower bound for `created_at`.

date_tostringe.g. "2026-05-31T23:59:59Z"

ISO 8601 datetime upper bound for `created_at`.

Headers

X-API-Keystringrequired

Your workspace API key.

Responses

200Array of bot summary objects.
[
  {
    "bot_id": "550e8400-e29b-41d4-a716-446655440000",
    "platform": "google_meet",
    "meeting_url": "https://meet.google.com/abc-defg-hij",
    "status": "completed",
    "completion_reason": "normal_completion",
    "start_time": "2026-05-12T10:05:00Z",
    "end_time": "2026-05-12T11:00:00Z",
    "created_at": "2026-05-12T10:00:00Z",
    "participants": [
      "Alice",
      "Bob"
    ],
    "languages": [
      "en"
    ],
    "recording_url": "https://storage.googleapis.com/serveka/rec.mp4?X-Goog-Expires=3600"
  }
]
400Malformed `date_from` or `date_to` — not a valid ISO 8601 datetime.
401Missing or invalid API key.