v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
CDR Usage Reports

Generates and fetches CDR Usage Reports

Generate and fetch voice usage report synchronously. This endpoint will both generate and fetch the voice report over a specified time period. No polling is necessary but the response may take up to a couple of minutes.

get/reports/cdr_usage_reports/sync

Query parameters

start_datestring date-time
Example:2020-07-01T00:00:00-06:00

Start of the date range filter (inclusive, ISO 8601).

end_datestring date-time
Example:2020-07-01T00:00:00-06:00

End of the date range filter (inclusive, ISO 8601).

aggregation_type'NO_AGGREGATION' | 'CONNECTION' | 'TAG' | 'BILLING_GROUP' required
Example:NO_AGGREGATION

Type of aggregation to apply to the results.

product_breakdown'NO_BREAKDOWN' | 'DID_VS_TOLL_FREE' | 'COUNTRY' | 'DID_VS_TOLL_FREE_PER_COUNTRY' required
Example:NO_BREAKDOWN

Filter results by product breakdown.

connectionsnumber[]

Filter results by connection.

[
  1234567890123
]

Response

Successful

Example response

{
  "data": {
    "connections": [
      1234567890,
      9876543210
    ],
    "created_at": "2018-02-02T22:25:27.521Z",
    "end_time": "2018-02-02T22:25:27.521Z",
    "record_type": "cdr_usage_report",
    "report_url": "http://portal.telnyx.com/downloads/report_name_8hvb45Gu.csv",
    "start_time": "2018-02-02T22:25:27.521Z",
    "updated_at": "2018-02-02T22:25:27.521Z"
  }
}