---
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.

## Changes

- **2026-08-19** `636788eb0d70` — 2 breaking, 2 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `401`
  - the response's body type/format changed from ``/`` to `object`/`` for status `404`
  - added the optional property `detail` to the response with the `401` status
  - added the optional property `detail` to the response with the `404` status
- **2026-08-17** `f04f8c465268` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/synthflow/apis/platform-api/changes/calls/batch/:batch_call_id/tasks/get.md)

---

[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/636788eb0d70/schema)