Get Call Batch

GET Get batch details

GET /api/v1/public/call-batches/{batch_id}

Retrieve the full details and current status of a specific call batch.

Authorization

Authorization: Bearer sk_your_api_key

Path Parameters

Parameter	Type	Required	Description
batch_id	string	✅	The batch/schedule ID (e.g., sched_7bac6f2a)

Code Examples

cURL

curl -X GET https://api.techladder.ai/api/v1/public/call-batches/sched_7bac6f2a \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Accept: application/json"

Python

import requests

batch_id = "sched_7bac6f2a"

response = requests.get(
    f"https://api.techladder.ai/api/v1/public/call-batches/{batch_id}",
    headers={"Authorization": "Bearer sk_your_api_key"},
)

print(response.json())

JavaScript

const batchId = "sched_7bac6f2a";

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

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

Java

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

String batchId = "sched_7bac6f2a";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.techladder.ai/api/v1/public/call-batches/" + batchId))
    .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

Full details for the requested batch.

{
  "status_code": 200,
  "message": "Call batch fetched successfully",
  "error": null,
  "data": {
    "batch_id": "sched_7bac6f2a",
    "agent_id": "agt-57949b14",
    "version_id": "pmt-667ddf271b",
    "status": "active",
    "start_mode": "scheduled",
    "scheduled_at": "2026-05-15T08:30:00Z",
    "timezone": "Asia/Kolkata",
    "concurrency": 20,
    "total_contacts": 150,
    "accepted_contacts": 148,
    "rejected_contacts": 2,
    "callbacks": 0,
    "queued": 72,
    "in_progress": 3,
    "completed": 75,
    "failed": 0,
    "cancelled": 0,
    "created_at": "2026-05-14T10:00:00Z",
    "started_at": "2026-05-15T08:30:02Z",
    "completed_at": null
  }
}

Field notes:

• queued + in_progress + completed + failed + cancelled sum to accepted_contacts (contacts that passed validation on create).
• rejected_contacts were dropped at create time and never dispatched — see the create-batch response's validation_errors for why.

401 Unauthorized

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

{
  "detail": "Invalid API key"
}

404 Not Found

Returned when the batch does not exist or is not owned by your account. This is not wrapped in the standard envelope.

{
  "detail": "Call batch not found"
}