MDR Usage Reports

Create a new legacy usage V2 MDR report request

Changed on

Creates a new legacy usage V2 MDR report request with the specified filters

post/legacy_reporting/usage_reports/messaging

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/legacy_reporting/usage_reports/messaging
  • Auth: HTTP bearer

Request body */*

start_timestring date-time
end_timestring date-time
aggregation_typeinteger required

Aggregation type: No aggregation = 0, By Messaging Profile = 1, By Tags = 2

profilesstring[]

List of messaging profile IDs to filter by

select_all_managed_accountsboolean
managed_accountsstring[]

List of managed accounts to include

Example request

{
  "start_time": "2020-01-01T00:00:00Z",
  "end_time": "2020-01-02T00:00:00Z",
  "profiles": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "7d4e3f8a-9b2c-4e1d-8f5a-1a2b3c4d5e6f"
  ],
  "select_all_managed_accounts": true,
  "managed_accounts": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ]
}

Response

V2 legacy MDR usage report request created successfully

Example response

{
  "data": {
    "start_time": "2018-02-02T22:25:27.521Z",
    "end_time": "2018-02-02T22:25:27.521Z",
    "connections": [
      "1234567890",
      "9876543210"
    ],
    "report_url": "http://portal.telnyx.com/downloads/report_name_8hvb45Gu.csv",
    "created_at": "2018-02-02T22:25:27.521Z",
    "updated_at": "2018-02-02T22:25:27.521Z",
    "profiles": [
      "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "7d4e3f8a-9b2c-4e1d-8f5a-1a2b3c4d5e6f"
    ],
    "record_type": "mdr_usage_report_v2_legacy"
  }
}

Changes