v52

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

Fetch all Messaging usage reports

Fetch all messaging usage reports. Usage reports are aggregated messaging data for specified time period and breakdown

get/reports/mdr_usage_reports

Query parameters

numberinteger

Page number

sizeinteger

Size of the page

Consolidated page parameter (deepObject style). Originally: page[number], page[size]

Response

Successful

Example response

{
  "data": [
    {
      "created_at": "2020-07-01T00:00:00-06:00",
      "end_date": "2020-07-01T00:00:00-06:00",
      "profiles": "My profile",
      "record_type": "mdr_usage_report",
      "report_url": "http://portal.telnyx.com/downloads/report_name_8hvb45Gu.csv",
      "result": [
        {
          "carrier_passthrough_fee": "0",
          "connection": "all",
          "cost": "0",
          "currency": "USD",
          "delivered": "0",
          "direction": "outbound",
          "message_type": "SMS",
          "parts": "0",
          "product": "outbound",
          "profile_id": "All",
          "received": "0",
          "sent": "0",
          "tags": "All",
          "tn_type": "TF"
        }
      ],
      "start_date": "2020-07-01T00:00:00-06:00",
      "updated_at": "2020-07-01T00:00:00-06:00"
    }
  ],
  "meta": {
    "page_number": 2,
    "page_size": 25,
    "total_pages": 3,
    "total_results": 55
  }
}