---
title: "List batch calls"
method: GET
path: "/calls/batch"
tags: ["batchCalls"]
---

# List batch calls

`GET /calls/batch`

Lists the workspace's batch calls, most recently created first.

## Query parameters

- `limit` integer
- `offset` integer

## Headers

- `Authorization` string, required

## Response `200`

200

- BatchCallsListBatchCallsResponse200
  - `status` string
  - `response` CallsBatchGetResponsesContentApplicationJsonSchemaResponse
    - `pagination` CallsBatchGetResponsesContentApplicationJsonSchemaResponsePagination
      - `total_records` integer
      - `limit` integer
      - `offset` integer
    - `batch_calls` BatchCallStatus[]
      - `batch_call_id` string
      - `name` string
      - `status` string — One of `scheduled`, `in_progress`, `paused`, `completed` or `canceled`.
      - `total_task_count` integer — Recipients stored in the batch.
      - `dispatched_count` integer — Recipients whose call was placed.
      - `failed_count` integer — Recipients whose call could not be placed.
      - `pending_count` integer — Recipients still waiting to be dialed.
      - `created_at` string
      - `model_id` string — The agent placing the calls.
      - `agent_name` string
      - `from_phone_number` string

## Other responses

- `401` — Missing or invalid API key.

---

[API](https://skmtc.dev/synthflow/apis/platform-api.md) · [All operations](https://skmtc.dev/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/synthflow/platform-api/revisions/6976456ad422/schema)