{
  "opencollection": "1.0.0",
  "info": {
    "name": "Telnyx Access Tokens MDR Usage Reports API",
    "version": "2.0.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "MDR Usage Reports",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List MDR usage reports",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.telnyx.com/v2/legacy/reporting/usage_reports/messaging",
            "params": [
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "Page number"
              },
              {
                "name": "per_page",
                "value": "",
                "type": "query",
                "description": "Size of the page"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Fetch all previous requests for MDR usage reports. "
        },
        {
          "info": {
            "name": "Create a new legacy usage V2 MDR report request",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.telnyx.com/v2/legacy/reporting/usage_reports/messaging",
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Creates a new legacy usage V2 MDR report request with the specified filters"
        },
        {
          "info": {
            "name": "Get an MDR usage report",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.telnyx.com/v2/legacy/reporting/usage_reports/messaging/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Fetch single MDR usage report by id."
        },
        {
          "info": {
            "name": "Delete a V2 legacy usage MDR report request",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.telnyx.com/v2/legacy/reporting/usage_reports/messaging/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Deletes a specific V2 legacy usage MDR report request by ID"
        },
        {
          "info": {
            "name": "Fetch all Messaging usage reports",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.telnyx.com/v2/reports/mdr_usage_reports",
            "params": [
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "Consolidated page parameter (deepObject style). Originally: page[number], page[size]"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Fetch all messaging usage reports. Usage reports are aggregated messaging data for specified time period and breakdown"
        },
        {
          "info": {
            "name": "Create MDR Usage Report",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.telnyx.com/v2/reports/mdr_usage_reports",
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Submit request for new new messaging usage report. This endpoint will pull and aggregate messaging data in specified time period. "
        },
        {
          "info": {
            "name": "Generate and fetch MDR Usage Report",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.telnyx.com/v2/reports/mdr_usage_reports/sync",
            "params": [
              {
                "name": "start_date",
                "value": "",
                "type": "query"
              },
              {
                "name": "end_date",
                "value": "",
                "type": "query"
              },
              {
                "name": "aggregation_type",
                "value": "",
                "type": "query"
              },
              {
                "name": "profiles",
                "value": "",
                "type": "query"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Generate and fetch messaging usage report synchronously. This endpoint will both generate and fetch the messaging report over a specified time period. No polling is necessary but the response may take up to a couple of minutes. "
        },
        {
          "info": {
            "name": "Retrieve messaging report",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.telnyx.com/v2/reports/mdr_usage_reports/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Fetch a single messaging usage report by id"
        },
        {
          "info": {
            "name": "Delete MDR Usage Report",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.telnyx.com/v2/reports/mdr_usage_reports/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Delete messaging usage report by id"
        }
      ]
    }
  ],
  "bundled": true
}