List Call Batches

GET List all call batches

GET /api/v1/public/call-batches

Retrieve a paginated list of all call batches for your account. Filter by agent ID, status, or both.

Authorization

Authorization: Bearer sk_your_api_key

Query Parameters

Parameter	Type	Required	Description
agent_id	string	❌	Filter by agent ID (e.g., agt-57949b14)
status	string	❌	Filter by status: pending, active, completed, cancelled (active matches any in-flight state, e.g. queued, running, dispatching)
created_at_from	string	❌	Only return batches created at or after this ISO 8601 timestamp
created_at_to	string	❌	Only return batches created at or before this ISO 8601 timestamp
limit	integer	❌	Results per page. Default: 50, Max: 200
page	integer	❌	Page number (1-indexed). Default: 1

Code Examples

cURL

curl -X GET "https://api.techladder.ai/api/v1/public/call-batches?agent_id=agt-57949b14&status=pending&limit=50&page=1" \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Accept: application/json"

Python

import requests

response = requests.get(
    "https://api.techladder.ai/api/v1/public/call-batches",
    headers={"Authorization": "Bearer sk_your_api_key"},
    params={
        "agent_id": "agt-57949b14",
        "status": "pending",
        "limit": 50,
        "page": 1,
    },
)

print(response.json())

JavaScript

const params = new URLSearchParams({
  agent_id: "agt-57949b14",
  status: "pending",
  limit: "50",
  page: "1",
});

const response = await fetch(
  `https://api.techladder.ai/api/v1/public/call-batches?${params}`,
  {
    headers: { Authorization: "Bearer sk_your_api_key" },
  }
);

const data = await response.json();
console.log(data);

Java

import java.net.URI;
import java.net.http.*;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.techladder.ai/api/v1/public/call-batches?agent_id=agt-57949b14&status=pending&limit=50&page=1"))
    .header("Authorization", "Bearer sk_your_api_key")
    .GET()
    .build();

HttpResponse<String> response = client.send(request,
    HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Responses

200 OK

A paginated list of call batches.

{
  "status_code": 200,
  "message": "Call batches fetched successfully",
  "error": null,
  "data": {
    "items": [
      {
        "batch_id": "sched_7bac6f2a",
        "agent_id": "agt-57949b14",
        "version_id": "pmt-667ddf271b",
        "status": "pending",
        "total_contacts": 150,
        "queued": 150,
        "in_progress": 0,
        "completed": 0,
        "failed": 0,
        "cancelled": 0,
        "created_at": "2026-05-14T10:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 1,
      "has_more": false
    }
  }
}

401 Unauthorized

Returned when the API key is missing or invalid. This is not wrapped in the standard envelope.

{
  "detail": "Invalid API key"
}

Batch Status Values

Status	Description
pending	Batch created but not yet started
paused	Batch created in manual start mode, waiting to be started
queued / dispatching / running	Batch is currently dispatching or running calls
completed	All calls in the batch have finished
cancelled	Batch was manually cancelled

Pass status=active to match any in-flight state (queued, running, dispatching, ringing, answered, in_progress, paused, pending) in one filter.