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.staging.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.staging.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.staging.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.staging.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": {
    "schedule_id": "sched_7bac6f2a",
    "agent_id": "agt-57949b14",
    "agent_name": "Customer Outreach Agent",
    "version_id": "pmt-667ddf271b",
    "status": "active",
    "start_mode": "scheduled",
    "voice": "Tara",
    "did_number": "08037236753",
    "total_contacts": 150,
    "completed_contacts": 75,
    "failed_contacts": 3,
    "pending_contacts": 72,
    "concurrency": 20,
    "recording_enabled": true,
    "scheduled_at": "2026-05-15T08:30:00Z",
    "started_at": "2026-05-15T08:30:02Z",
    "created_at": "2026-05-14T10:00:00Z",
    "updated_at": "2026-05-15T09:15:30Z"
  }
}

401 Unauthorized

Returned when the API key is missing or invalid.

{
  "status_code": 401,
  "message": "Missing or invalid API key",
  "error": {
    "code": "UNAUTHORIZED",
    "details": ["Provide a valid Bearer token in the Authorization header"]
  },
  "data": null
}

404 Not Found

Returned when the batch does not exist or is not owned by your account.

{
  "status_code": 404,
  "message": "Batch not found",
  "error": {
    "code": "NOT_FOUND",
    "details": ["No batch found with id sched_7bac6f2a"]
  },
  "data": null
}