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
limit	integer	❌	Results per page. Default: 100, Max: 500
page	integer	❌	Page number. Default: 1

Code Examples

cURL

curl -X GET "https://api.staging.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.staging.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.staging.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.staging.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": {
    "items": [
      {
        "call_id": "call_a1b2c3d4",
        "external_id": "101",
        "phone_number": "919876543210",
        "name": "John Doe",
        "status": "completed",
        "duration_seconds": 145,
        "answer_duration_seconds": 132,
        "disconnect_reason": "agent_hangup",
        "transcript_status": "ready",
        "analysis_status": "ready",
        "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,
          "file_key": "recordings/call_a1b2c3d4.wav"
        },
        "started_at": "2026-05-15T08:30:05Z",
        "ended_at": "2026-05-15T08:32:30Z"
      }
    ],
    "total": 150,
    "page": 1,
    "limit": 100,
    "has_more": true
  }
}

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_5d398018"]
  },
  "data": null
}

Result Fields

Field	Type	Description
call_id	string	Unique call identifier
external_id	string	Your contact ID
status	string	Final call status
duration_seconds	integer	Total call duration
answer_duration_seconds	integer	Duration after answer
disconnect_reason	string	Why the call ended
transcript_status	string	disabled, pending, processing, ready, failed
analysis_status	string	disabled, 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.file_key	string	File key used to retrieve the recording from storage