---
title: "Get a batch call"
method: GET
path: "/calls/batch/{batch_call_id}"
tags: ["batchCalls"]
---

# Get a batch call

`GET /calls/batch/{batch_call_id}`

Returns the batch's status and its recipient counters.

## Path parameters

- `batch_call_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

200

- BatchCallsGetABatchCallResponse200
  - `status` string
  - `response` 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.
- `404` — No batch with that id exists in the workspace.

---

[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)