> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Batch Call

> Fetch a batch call job's configuration, status, and live progress counters.

<Warning>
  **Legacy endpoint - deprecated.** Unversioned endpoints are scheduled for removal on **July 31, 2026**. Use the [`/v1` version](/docs/api-reference/v1/batches/get) for new integrations. This endpoint remains available for existing integrations until then.
</Warning>

Returns the full record for a single batch call job: the display `name`, the current `status` (`queued`, `processing`, `completed`, `failed`, `cancelled`), the assigned `agent_id`, progress counters (`total_calls`, `completed_calls`, `failed_calls`), and creation timestamps. Use this endpoint to poll a batch's progress while it is running, render a batch detail page, or audit the configuration of a completed batch before kicking off a re-run.

## When to use this

* **Operational dashboards**: render the batch detail page with live progress.
* **Status polling**: periodically check `completed_calls` to estimate when a batch will finish.
* **Audit logs**: confirm which agent and configuration a batch ran with.
* **Re-run preparation**: fetch a previous batch's configuration before creating a new batch with [Create Batch Call](/docs/api-reference/v1/batches/create).

To list every batch, use [List Batch Calls](/docs/api-reference/v1/batches/list). For the call logs produced by a batch, fetch them through [List Call Logs](/docs/api-reference/call-logs/list) filtered by the batch ID.

## Path parameters

| Parameter | Description                                        |
| --------- | -------------------------------------------------- |
| `id`      | The batch call ID, for example `bat_q1r5sv9mdk3z`. |

## Errors

* `404 Not Found` is returned when the batch does not exist.

## Related endpoints

* [List Batch Calls](/docs/api-reference/v1/batches/list): browse all batches.
* [Create Batch Call](/docs/api-reference/v1/batches/create): start a new batch.
* [Batch calling](/docs/batch-calls/overview): guidance on designing a batch.
* [Concurrency and limits](/docs/reference/limits): pacing batches against your workspace limits.


## OpenAPI

````yaml GET /batch-calls/{id}
openapi: 3.0.0
info:
  title: DialNexa API
  description: >-
    Public REST API for the DialNexa voice AI platform. Versioned endpoints are
    under /v1; unversioned endpoints are legacy and deprecated.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: API Keys
  - name: Agent Functions
  - name: Agents V1
  - name: Agents2
  - name: Batch Calls
  - name: Batch Calls V1
  - name: Call Logs
  - name: Calls
  - name: Calls V1
  - name: Campaign Leads
  - name: Campaigns
  - name: External Webhooks
  - name: Knowledge Base
  - name: Knowledge Base V1
  - name: LLMs
  - name: LLMs V1
  - name: Languages
  - name: Languages V1
  - name: Organization Phone Numbers
  - name: Organization Phone Numbers V1
  - name: Phone Number Pricing
  - name: Phone Number Pricing V1
  - name: Transcribers
  - name: Transcribers V1
  - name: User Webhooks
  - name: User Webhooks V1
  - name: V1
  - name: Voices
  - name: Voices V1
  - name: Webcall
  - name: Workflow Leads
  - name: Workflow Leads V1
  - name: Workflows
  - name: Workflows V1
paths:
  /batch-calls/{id}:
    get:
      tags:
        - Batch Calls
      summary: List calls within a batch by ID
      description: >-
        **Legacy endpoint - deprecated, scheduled for removal on July 31,
        2026.** Use the `/v1` version for new integrations. 
      operationId: BatchCallsController_listCallsInBatch
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
        - name: agent_id
          required: false
          in: query
          description: >-
            Filter by agent ID(s) - can be a single ID or comma-separated list
            (e.g., 1,2,3)
          schema:
            type: string
        - name: call_id
          required: false
          in: query
          description: >-
            Filter by call ID - can be a single ID or comma-separated list
            (e.g., call_abc,call_def)
          schema:
            type: string
        - name: batch_call_id
          required: false
          in: query
          description: >-
            Filter by batch call ID - can be a single ID or comma-separated list
            (e.g., batch_abc,batch_def)
          schema:
            type: string
        - name: from
          required: false
          in: query
          description: Filter by sender phone number
          schema:
            type: string
        - name: to
          required: false
          in: query
          description: Filter by recipient phone number
          schema:
            type: string
        - name: type
          required: false
          in: query
          description: >-
            Filter by call type(s) - can be a single value or comma-separated
            list
          schema:
            type: string
            enum:
              - phone
              - web
        - name: call_direction
          required: false
          in: query
          description: >-
            Filter by call direction(s) - can be a single value or
            comma-separated list
          schema:
            type: string
            enum:
              - inbound
              - outbound
        - name: latency_min
          required: false
          in: query
          description: Filter by minimum latency (in milliseconds)
          schema:
            type: number
        - name: latency_max
          required: false
          in: query
          description: Filter by maximum latency (in milliseconds)
          schema:
            type: number
        - name: agent_version_id
          required: false
          in: query
          description: >-
            Filter by agent version ID(s) - can be a single ID or
            comma-separated list (e.g., 1,2,3)
          schema:
            type: string
        - name: agent_version_name
          required: false
          in: query
          description: Search by agent version name (partial match, case-insensitive)
          schema:
            type: string
        - name: sentiment
          required: false
          in: query
          description: >-
            Filter by sentiment(s) - can be a single value or comma-separated
            list
          schema:
            type: string
            enum:
              - positive
              - neutral
              - negative
              - unknown
        - name: start_date
          required: false
          in: query
          description: Filter by start date (ISO format)
          schema:
            type: string
        - name: end_date
          required: false
          in: query
          description: Filter by end date (ISO format)
          schema:
            type: string
        - name: duration_greater_than
          required: false
          in: query
          description: Filter by minimum call duration (in milliseconds)
          schema:
            type: number
        - name: duration_less_than
          required: false
          in: query
          description: Filter by maximum call duration (in milliseconds)
          schema:
            type: number
        - name: duration_min
          required: false
          in: query
          description: Filter by minimum duration range (in milliseconds)
          schema:
            type: number
        - name: duration_max
          required: false
          in: query
          description: Filter by maximum duration range (in milliseconds)
          schema:
            type: number
        - name: page
          required: false
          in: query
          description: Page number (starts from 1)
          schema:
            type: string
        - name: limit
          required: false
          in: query
          description: 'Number of records per page (min: 1, default: 20, max: 200)'
          schema:
            type: string
        - name: created_at
          required: false
          in: query
          description: Sort by created_at (asc or desc)
          schema:
            type: string
            enum:
              - asc
              - desc
        - name: duration
          required: false
          in: query
          description: Sort by duration (asc or desc)
          schema:
            type: string
            enum:
              - asc
              - desc
        - name: status
          required: false
          in: query
          description: >-
            Filter by call status(es) - can be a single status or
            comma-separated list
          schema:
            type: string
        - name: export
          required: false
          in: query
          description: Set to true to export all data without pagination
          schema:
            type: boolean
        - name: x-organization-id
          in: header
          description: RSA encrypted organization ID (base64 format)
          required: true
          schema:
            type: string
            example: BASE64_ENCRYPTED_ORG_ID_HERE
      responses:
        '200':
          description: Calls in the batch fetched successfully
      deprecated: true
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````