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

# Get batch call by ID

> Retrieves a batch call by ID.

## Notes

* Batch call IDs must match `batch_call_[a-fA-F0-9]{32}`.


## OpenAPI

````yaml get /batch-call/{id}
openapi: 3.0.3
info:
  title: Zudu API
  description: >-
    Comprehensive REST API for LiveKit Backend - Call Management, Agent
    Configuration, and Real-time Communication Services
  version: 1.0.0
  contact:
    name: Zudu AI Team
    url: https://zudu.ai
    email: support@zudu.ai
  license:
    name: Proprietary
    url: https://zudu.ai/license
servers:
  - url: https://api.zudu.ai
    description: Production (Customer-facing)
security:
  - apiKey: []
    apiSecret: []
tags:
  - name: Agent Management
    description: Create and manage AI agents
  - name: Call Data Management
    description: Call records and history
  - name: Customer API Keys
    description: Manage API keys
  - name: Post-Call Webhooks
    description: Webhook configuration
  - name: phone-number-controller
    description: Phone numbers
  - name: batch-call-controller
    description: Batch calls
  - name: MCP Server Management
    description: MCP servers
  - name: Knowledge Base Management
    description: Knowledge bases
  - name: Call Analysis
    description: Call analysis
paths:
  /batch-call/{id}:
    get:
      tags:
        - batch-call-controller
      summary: Get batch call by ID
      description: >-
        Retrieves a batch call by ID. Requires orgId header. ID format:
        batch_call_[32-hex-chars].
      operationId: getBatchCall
      parameters:
        - name: id
          in: path
          required: true
          description: Batch call ID (batch_call_[32-hex-chars])
          schema:
            type: string
            example: batch_call_a1b2c3d4e5f6789012345678901234567
      responses:
        '200':
          description: Batch call retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  error:
                    type: string
                    nullable: true
                  data:
                    type: object
              example:
                message: Batch call retrieved successfully
                status: success
                error: null
                data:
                  batch_call_id: batch_call_a1b2c3d4e5f6789012345678901234567
                  name: Q1 Sales Campaign
                  from_number: '+14157774444'
                  scheduled_timestamp: 1735718400000
                  total_task_count: 100
                  total: 100
                  sent: 100
                  picked_up: 75
                  completed: 68
                  agent_id: agent_7ff47846-c8a0-4304-ae13-88cfc31c1a03
                  organization_id: e3yn0c4mivqs8y4yhb5k
                  status: completed
                  timezone: UTC
                  last_sent_timestamp: 1735718500000
                  tasks_url: https://storage.azure.com/.../tasks.json
                  created_timestamp: 1735718400000
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  error:
                    type: string
                    nullable: true
                  data:
                    type: string
                    nullable: true
              example:
                message: Invalid request
                status: error
                error: >-
                  Batch call ID must be in format:
                  batch_call_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (32 hex
                  characters)
                data: null
        '403':
          description: Access denied
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  error:
                    type: string
                    nullable: true
                  data:
                    type: string
                    nullable: true
              example:
                message: Access denied
                status: error
                error: Batch call does not belong to your organization
                data: null
        '404':
          description: Batch call not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  error:
                    type: string
                    nullable: true
                  data:
                    type: string
                    nullable: true
              example:
                message: Batch call not found
                status: error
                error: Batch call with ID batch_call_xxx does not exist
                data: null
components:
  securitySchemes:
    apiKey:
      type: apiKey
      description: API Key for MCP server and external service authentication
      name: X-API-KEY
      in: header
    apiSecret:
      type: apiKey
      description: API Secret for MCP server and external service authentication
      name: X-API-SECRET
      in: header

````