Skip to main content
GET
/
batch-call
/
list
curl -X GET "https://api.zudu.ai/batch-call/list?page=0&limit=20&sort_by=created_at&sort_order=descending" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "Batch calls retrieved successfully",
  "status": "success",
  "data": {
    "batch_calls": [
      {
        "batch_call_id": "batch_abc123",
        "name": "Customer Follow-up Campaign",
        "status": "COMPLETED",
        "total_task_count": 100,
        "created_at": "2024-01-15T10:30:00Z"
      }
    ],
    "pagination": {
      "page": 0,
      "limit": 20,
      "total_count": 50,
      "total_pages": 3
    },
    "returned_count": 20
  }
Retrieve a paginated list of batch calls for your organization. When no limit parameter is provided, all batch calls are returned. 
curl -X GET "https://api.zudu.ai/batch-call/list?page=0&limit=20&sort_by=created_at&sort_order=descending" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "Batch calls retrieved successfully",
  "status": "success",
  "data": {
    "batch_calls": [
      {
        "batch_call_id": "batch_abc123",
        "name": "Customer Follow-up Campaign",
        "status": "COMPLETED",
        "total_task_count": 100,
        "created_at": "2024-01-15T10:30:00Z"
      }
    ],
    "pagination": {
      "page": 0,
      "limit": 20,
      "total_count": 50,
      "total_pages": 3
    },
    "returned_count": 20
  }

​
Headers

​
X-API-KEY
string
required
Your API key (format: sk_...)
​
X-API-SECRET
string
required
Your API secret (format: s3cr3t_...)

​
Query Parameters

​
page
number
Page number (0-based, default: 0)Minimum: 0
​
limit
number
Number of results per page (default: 20, max: 100)Important: If limit is not provided, ALL batch calls are returned (no pagination).Range: 1 to 100
​
sort_by
string
Field to sort by (default: updated_at)Options: created_at, updated_at, scheduled_timestamp, name, status, total_task_count
​
sort_order
string
Sort direction (default: descending)Options: ascending, descending

​
Response Fields

​
batch_calls
array
Array of batch call objects
​
pagination
object
Pagination metadata:
  • page: Current page number
  • limit: Results per page
  • total_count: Total number of batch calls
  • total_pages: Total number of pages
​
returned_count
number
Number of batch calls returned in this response

​
Notes

  • When limit is not provided, all batch calls are returned (not paginated)
  • Results are scoped to your organization automatically
  • Sorting is applied after retrieval for optimal performance