Skip to main content

Create an MDR usage report

POST 
/reporting/mdr_usage_reports

Check the status and retrieve a MDR Usage Report with a call to GET /reporting/mdr_usage_reports/{id}. MDR Usage Reports are available for 30 days.

Request ​

Body

required

Mdr Usage Report to add

    start_time stringrequired

    UTC (2024-11-01T00:00:00+00:00)

    end_time string

    UTC (2024-11-01T12:23:23+00:00). Must be less than 24 hours from now

    aggregation_type integer

    Default value: 0

    Aggregate: All = 0, By Profile = 1

    profiles string[]

    Array of profile IDs

Responses ​

200: MdrUsageReport response

Schema

    id stringrequired
    start_time stringrequired

    UTC (2024-11-01T00:00:00+00:00)

    end_time stringrequired

    UTC (2024-11-01T12:23:23+00:00)

    aggregation_type integerrequired

    Default value: 0

    Aggregate by: All = 0, By Profile = 1

    status integerrequired

    Default value: 1

    Pending = 1, Complete = 2, Failed = 3, Expired = 4

    report_url stringrequired

    Link to report

    result objectrequired

    Report results

    created_at stringrequired
    updated_at stringrequired
    profiles string[]

    Array of profile IDs

400: Bad request

401: Unauthorized

Request samples

curl -L 'https://api.telnyx.com/reporting/mdr_usage_reports' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "start_time": "string",
  "end_time": "string",
  "aggregation_type": 0,
  "profiles": [
    "string"
  ]
}'

Response samples

{
  "id": "string",
  "start_time": "string",
  "end_time": "string",
  "aggregation_type": 0,
  "status": 1,
  "report_url": "string",
  "result": {},
  "created_at": "string",
  "updated_at": "string",
  "profiles": [
    "string"
  ]
}