List Call Records

GET List call records by date range

GET /api/v1/public/call-records

Retrieve a paginated list of call records for your account within an inclusive UTC calendar-day range. Unlike List Batch Calls, this endpoint is account-scoped rather than batch-scoped, so it returns calls across every batch. Optionally filter by one or more agent IDs.

Authorization

Authorization: Bearer sk_your_api_key

Query Parameters

Parameter	Type	Required	Description
start_date	string	✅	Inclusive UTC start date, YYYY-MM-DD
end_date	string	✅	Inclusive UTC end date, YYYY-MM-DD
agent_id	array[string]	❌	Filter by agent ID(s). Repeat the parameter to filter by multiple agents (e.g., agent_id=agt-57949b14&agent_id=agt-6b2f01ac)
page	integer	❌	Page number (1-indexed). Default: 1
page_size	integer	❌	Results per page. Default: 50, Max: 200

Code Examples

cURL

curl -X GET "https://api.techladder.ai/api/v1/public/call-records?start_date=2026-05-01&end_date=2026-05-31&agent_id=agt-57949b14&agent_id=agt-6b2f01ac&page=1&page_size=50" \
  -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-records",
    headers={"Authorization": "Bearer sk_your_api_key"},
    params={
        "start_date": "2026-05-01",
        "end_date": "2026-05-31",
        "agent_id": ["agt-57949b14", "agt-6b2f01ac"],
        "page": 1,
        "page_size": 50,
    },
)

print(response.json())

JavaScript

const params = new URLSearchParams({
  start_date: "2026-05-01",
  end_date: "2026-05-31",
  page: "1",
  page_size: "50",
});
["agt-57949b14", "agt-6b2f01ac"].forEach((id) => params.append("agent_id", id));

const response = await fetch(
  `https://api.techladder.ai/api/v1/public/call-records?${params}`,
  {
    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-records?start_date=2026-05-01&end_date=2026-05-31&agent_id=agt-57949b14&agent_id=agt-6b2f01ac&page=1&page_size=50"))
    .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 records within the date range.

{
  "status_code": 200,
  "message": "Call records fetched successfully",
  "error": null,
  "data": {
    "items": [
      {
        "call_id": "call_a1b2c3d4",
        "batch_id": "sched_bdb2b840",
        "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": "completed",
        "duration_seconds": 96,
        "answer_duration_seconds": 88,
        "timestamp": "2026-05-14T10:00:00Z",
        "created_at": "2026-05-14T10:00:00Z",
        "completed_at": "2026-05-14T10:01:36Z",
        "hangup_by": "user",
        "disconnect_reason": "normal",
        "summary": "Contact confirmed interest and requested a callback next week.",
        "outcomes": null,
        "recording_available": true,
        "recording_url": "https://.../recording.wav?signature=...",
        "llm_transcript": null
      }
    ],
    "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"
}

422 Unprocessable Content

Returned when start_date is after end_date, or page_size exceeds the maximum allowed value. This is not wrapped in the standard envelope.

{
  "detail": "start_date must be on or before end_date"
}

{
  "detail": "page_size must be less than or equal to 200"
}

Notes

• start_date and end_date represent inclusive UTC calendar days, not timestamps.
• Records are scoped to your account (API key's client) and span every batch, so this is the endpoint to use when you want everything dialed in a date range regardless of which batch it belongs to.
• When multiple agent_id values are provided, records matching any of them are returned.
• Each item uses the same document format as List Batch Calls.