Get Batch Results

GET Get batch call results

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

Retrieve the outcomes, transcripts, and analysis results for all calls in a batch. This endpoint returns detailed per-call results including AI-extracted outcomes.

Authorization

Authorization: Bearer sk_your_api_key

Path Parameters

Parameter	Type	Required	Description
batch_id	string	✅	The batch/schedule ID

Query Parameters

Parameter	Type	Required	Description
outcome	string	❌	Filter by a specific value in the call's AI-extracted outcomes
status	string	❌	Filter by call status
transcript_status	string	❌	Filter by transcript status (e.g. ready, processing)
limit	integer	❌	Results per page. Default: 100, Max: 200
page	integer	❌	Page number. Default: 1

Code Examples

cURL

curl -X GET "https://api.techladder.ai/api/v1/public/call-batches/sched_5d398018/results?limit=100&page=1" \
  -H "Authorization: Bearer sk_your_api_key"

Python

import requests

batch_id = "sched_5d398018"

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

print(response.json())

JavaScript

const batchId = "sched_5d398018";

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

console.log(await response.json());

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/sched_5d398018/results?limit=100&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 results with AI-extracted outcomes.

{
  "status_code": 200,
  "message": "Batch results fetched successfully",
  "error": null,
  "data": {
    "status": "completed",
    "items": [
      {
        "call_id": "call_a1b2c3d4",
        "batch_id": "sched_5d398018",
        "contact_id": "101",
        "external_id": "101",
        "phone_number": "919876543210",
        "agent_id": "agt-57949b14",
        "agent_name": "Customer Outreach Agent",
        "version_id": "pmt-667ddf271b",
        "version_name": "v3",
        "voice": "Tara",
        "status": "completed",
        "call_status": "completed",
        "transcript_status": "ready",
        "duration_seconds": 145,
        "answer_duration_seconds": 132,
        "timestamp": "2026-05-15T08:30:05Z",
        "created_at": "2026-05-15T08:30:05Z",
        "completed_at": "2026-05-15T08:32:30Z",
        "hangup_by": "agent",
        "disconnect_reason": "agent_hangup",
        "summary": "Customer was interested in the product demo. Agreed to a follow-up call next week.",
        "outcomes": {
          "Interested": "Yes",
          "Follow Up Required": "Yes",
          "Callback Date": "2026-05-20",
          "Product Interest": "Premium Plan"
        },
        "recording_available": true,
        "recording_url": "https://.../recordings/call_a1b2c3d4.wav",
        "llm_transcript": "Agent: Hello, this is..."
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 100,
      "total": 150,
      "has_more": true
    }
  }
}

The top-level status field summarizes the batch's results as a whole: pending (contacts still awaiting a result), completed (all results are in), or cancelled.

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"
}

Result Item Fields

Field	Type	Description
call_id	string	Unique call identifier
batch_id	string	The batch this call belongs to
contact_id / external_id	string	Your contact ID
phone_number	string	Number dialed
agent_id / agent_name	string	Agent that handled the call
version_id / version_name	string	Prompt version used
voice	string	Voice used for the call
status / call_status	string	Final call status
duration_seconds	integer	Total call duration
answer_duration_seconds	integer	Duration after answer
hangup_by	string	Who ended the call (agent, user, system)
disconnect_reason	string	Why the call ended
transcript_status	string	e.g. pending, processing, ready, failed
summary	string	AI-generated call summary
outcomes	object	AI-extracted call outcomes (configured per agent)
recording_available	boolean	Whether a recording exists
recording_url	string	URL to retrieve the recording
llm_transcript	string	Full call transcript