---
title: "Get Telnyx product usage data (BETA)"
method: GET
path: "/usage_reports"
tags: ["Usage Reports (BETA)"]
---

# Get Telnyx product usage data (BETA)

`GET /usage_reports`

Get Telnyx usage data by product, broken out by the specified dimensions

## Query parameters

- `product` string, required
- `dimensions` string[], required
- `metrics` string[], required
- `start_date` string
- `end_date` string
- `date_range` string
- `filter` string
- `managed_accounts` boolean
- `sort` string[]
- `format` 'csv' | 'json'
- `page` object
  - `number` integer
  - `size` integer

## Headers

- `authorization_bearer` string — Authenticates the request with your Telnyx API V2 KEY

## Response `200`

Successful

- UsageReportsResponse
  - `meta` PaginationData
    - `total_pages` integer — Total number of pages.
    - `total_results` integer — Total number of results.
    - `page_number` integer — Selected page number.
    - `page_size` integer — Records per single page
  - `data` object[]

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)