---
title: "List batch call recipients"
method: GET
path: "/calls/batch/{batch_call_id}/tasks"
tags: ["batchCalls"]
---

# List batch call recipients

`GET /calls/batch/{batch_call_id}/tasks`

Lists every recipient in the batch with its outcome, in the order they were added. Unlike listing calls filtered by `batch_call_id`, this includes recipients that are still queued and recipients that failed before a call was placed, with the reason in `error_message`.

## Path parameters

- `batch_call_id` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'pending' | 'claimed' | 'dispatched' | 'failed' | 'canceled'

## Headers

- `Authorization` string, required

## Response `200`

200

- BatchCallsListBatchCallRecipientsResponse200
  - `status` string
  - `response` CallsBatchBatchCallIdTasksGetResponsesContentApplicationJsonSchemaResponse
    - `pagination` CallsBatchBatchCallIdTasksGetResponsesContentApplicationJsonSchemaResponsePagination
      - `total_records` integer
      - `limit` integer
      - `offset` integer
    - `tasks` CallsBatchBatchCallIdTasksGetResponsesContentApplicationJsonSchemaResponseTasksItems[]
      - `task_id` string
      - `to_phone_number` string
      - `lead_name` string
      - `lead_email` string
      - `status` string — One of `pending`, `claimed`, `dispatched`, `failed` or `canceled`.
      - `error_message` string — Why the recipient failed. Null unless `status` is `failed`.
      - `call_id` string — The call placed for this recipient. Null while the recipient is queued.
      - `created_at` string
      - `updated_at` 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)