---
title: "List inbound (origination) call records to DID numbers, paginated"
method: GET
path: "/call_records/origination"
tags: ["Calls"]
---

# List inbound (origination) call records to DID numbers, paginated

`GET /call_records/origination`

## Request

- Base URL: `https://api.commpeak.com/portal`
- URL: `https://api.commpeak.com/portal/call_records/origination`
- Auth: API key in header `Authorization`

Returns the customer's inbound call detail records (CDRs) — calls received on the customer's DID numbers — newest first. Without `time_range` the last 24 hours are returned. Results can be narrowed to one or more DID numbers with `did`; numbers that do not belong to the customer are ignored. Pagination is by `page` and `per_page` (default 100, max 1000); keep requesting the next page until an empty `call_records` array is returned, which signals end-of-data.

## Query parameters

- `time_range` string, nullable: Time range "YYYY-MM-DD - YYYY-MM-DD".
- `did[]` string[], nullable: Filter by called DID numbers in E.164 format.
- `page` integer, nullable: Page number (default 1).
- `per_page` integer, nullable: Items per page (default 100, max 1000).

## Response `200`

Successful Response

- CallRecordsResponse: Envelope for `/portal/call_records/termination` and `/portal/call_records/origination`. Pagination is request-driven (`page`, `per_page`); an empty `call_records` array signals end-of-data.
  - `call_records` CallRecordItem[], required: Page of call records. An empty array signals end-of-data.
    - `started_at` string, required: Call start time as ISO 8601 with timezone offset (e.g. "2026-05-26T12:16:50.000+00:00").
    - `status` string, required: Hangup cause from upstream (e.g. "ANSWER", "NO_ANSWER", "BUSY").
    - `cli` string, required: Caller ID (E.164 without leading "+"; may be empty for origination calls).
    - `destination` string, required: Called number in E.164 (no leading "+").
    - `duration` integer, required: Session duration in seconds.
    - `cost` number, required: Total call cost in customer currency.
    - `tech_prefix` string, nullable: Tech prefix used for the call (set on termination CDRs only).
    - `destination_name` string, nullable: Human-readable destination name (country + network).

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-portal-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-portal-api/revisions/df57b0c16367?raw)