---
title: "Find batches in a call broadcast"
method: GET
path: "/calls/broadcasts/{id}/batches"
tags: ["calls"]
---

# Find batches in a call broadcast

`GET /calls/broadcasts/{id}/batches`

This endpoint will enable the user to page through all of the batches for a particular voice broadcast campaign

## Path parameters

- `id` integer, required

## Query parameters

- `fields` string
- `limit` integer
- `offset` integer

## Response `200`

successful operation

- BatchPage — ~
  - `items` object[] — A list of returned items
    - `id` integer — A id of a batch
    - `name` string — A batch name
    - `status` 'NEW' | 'VALIDATING' | 'ERRORS' | 'SOURCE_ERROR' | 'ACTIVE' — A status of batch (NEW, VALIDATING, ERRORS, SOURCE_ERROR, ACTIVE). NEW - batch is queued for validation; VALIDATING - batch is currently validating; ERRORS - batch is processed, some validation errors occurred; SOURCE_ERROR - if contact source is contact list in CallFire system and it has an error; ACTIVE - batch is processed and ready
    - `broadcastId` integer — An id of broadcast which batch belongs to
    - `created` integer — A date and time when batch was created, formatted in unix time milliseconds. Example: 1473781817000 for Sat, 05 Jan 1985 14:03:37 GMT
    - `size` integer — A total number of contacts in batch
    - `remaining` integer — A number of contacts remaining undialed/untexted
    - `enabled` boolean — An enabled batch. If batch is disabled its contacts remain undialed/untexted
  - `limit` integer — A maximum number of returned items. If items.size() < limit assume no more items
  - `offset` integer — An offset from a start of paging source
  - `totalCount` integer — Total count of available results. -1 if unknown

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.net/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/versions/9f6fb501bc03/schema)