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

# List batch calls

> Lists batch calls with pagination and sorting.

## Notes

* Omit `limit` (or set it to `null`) to return all batch calls.
* `performance_mode` supports `fast`, `accurate`, and `ultra_fast`.


## OpenAPI

````yaml get /batch-call/list
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/list:
    get:
      tags:
        - batch-call-controller
      summary: List batch calls
      description: >-
        Lists batch calls with pagination and sorting. Requires orgId header.
        Omit limit or set null to return ALL batch calls.
      operationId: listBatchCalls
      parameters:
        - name: page
          in: query
          required: false
          description: 'Page number (0-based, default: 0)'
          schema:
            type: integer
            format: int32
            minimum: 0
            default: 0
            example: 0
        - name: limit
          in: query
          required: false
          description: 'Items per page (default: 20, max: 100). Omit/null for ALL data'
          schema:
            type: integer
            format: int32
            minimum: 1
            maximum: 100
            default: 20
            example: 20
        - name: sort_by
          in: query
          required: false
          description: >-
            Sort field: created_at, updated_at, scheduled_timestamp, name,
            status, total_task_count
          schema:
            type: string
            default: updated_at
            example: updated_at
        - name: sort_order
          in: query
          required: false
          description: 'Sort direction: ascending, descending'
          schema:
            type: string
            default: descending
            example: descending
        - name: size
          in: query
          required: false
          description: Alternate page size parameter
          schema:
            type: integer
            format: int32
        - name: performance_mode
          in: query
          required: false
          description: 'Performance mode: fast, accurate, ultra_fast'
          schema:
            type: string
      responses:
        '200':
          description: Batch calls retrieved successfully with real-time metrics
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  error:
                    type: string
                    nullable: true
                  data:
                    type: object
                    properties:
                      organization_id:
                        type: string
                      batch_calls:
                        type: array
                        items:
                          type: object
                      pagination:
                        type: object
                      returned_count:
                        type: integer
                      sort_order:
                        type: string
                      sort_by:
                        type: string
              example:
                message: Batch calls retrieved successfully with real-time metrics
                status: success
                error: null
                data:
                  organization_id: e3yn0c4mivqs8y4yhb5k
                  batch_calls:
                    - batch_call_id: batch_call_a1b2c3d4e5f6789012345678901234567
                      name: Q1 Sales Campaign
                      from_number: '+14157774444'
                      status: completed
                      total_task_count: 100
                      sent: 100
                      picked_up: 75
                      completed: 68
                      scheduled_timestamp: 1735718400
                      agent_id: agent_uuid-here
                      organization_id: e3yn0c4mivqs8y4yhb5k
                  pagination:
                    page: 0
                    limit: 20
                    total_count: 45
                    total_pages: 3
                    has_next_page: true
                    has_previous_page: false
                  returned_count: 20
                  sort_order: descending
                  sort_by: updated_at
        '400':
          description: Invalid request parameters
          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 parameters
                status: error
                error: Page number must be 0 or greater; Page size cannot exceed 100
                data: null
        '401':
          description: Missing required header
          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: Missing required header
                status: error
                error: orgId header is required for this operation
                data: null
        '500':
          description: Failed to list batch calls
          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: Failed to list batch calls
                status: error
                error: Internal server error occurred
                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

````