Skip to main content
GET
/
batch-call
/
{id}
/
tasks
curl -X GET "https://api.zudu.ai/batch-call/batch_abc123/tasks?page=0&limit=50" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "Batch call tasks retrieved successfully",
  "status": "success",
  "data": {
    "tasks": [
      {
        "task_id": "task_abc123",
        "to_number": "+15559876543",
        "status": "COMPLETED",
        "call_id": "call_xyz789",
        "error_message": null,
        "created_at": "2024-01-15T10:30:00Z"
      }
    ],
    "pagination": {
      "page": 0,
      "limit": 50,
      "total_count": 100
    }
}
Get the list of tasks (phone numbers) for a batch call with their individual statuses and results. 
curl -X GET "https://api.zudu.ai/batch-call/batch_abc123/tasks?page=0&limit=50" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "Batch call tasks retrieved successfully",
  "status": "success",
  "data": {
    "tasks": [
      {
        "task_id": "task_abc123",
        "to_number": "+15559876543",
        "status": "COMPLETED",
        "call_id": "call_xyz789",
        "error_message": null,
        "created_at": "2024-01-15T10:30:00Z"
      }
    ],
    "pagination": {
      "page": 0,
      "limit": 50,
      "total_count": 100
    }
}

​
Headers

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

​
Path Parameters

​
id
string
required
The batch call ID (format: batch_...)

​
Query Parameters

​
page
number
Page number (0-based, default: 0)
​
limit
number
Results per page (default: 50, max: 100)

​
Response Fields

​
tasks
array
Array of task objects with:
  • task_id: Unique task identifier
  • to_number: Destination phone number
  • status: Task status (PENDING, CALLING, COMPLETED, FAILED)
  • call_id: Associated call ID (if call was made)
  • error_message: Error message (if task failed)
​
pagination
object
Pagination metadata

​
Error Responses

​
error
string
Not Found - Batch call does not exist