---
title: "Get Usage Reports query options (BETA)"
method: GET
path: "/usage_reports/options"
tags: ["Usage Reports (BETA)"]
---

# Get Usage Reports query options (BETA)

`GET /usage_reports/options`

Get the Usage Reports options for querying usage, including the products available and their respective metrics and dimensions

## Query parameters

- `product` string

## Headers

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

## Response `200`

Successful

- UsageReportsOptionsResponse — An object following one of the schemas published in https://developers.telnyx.com/docs/api/v2/detail-records
  - `data` UsageReportsOptionsRecord[] — Collection of product description
    - `product` string — Telnyx Product
    - `product_dimensions` string[] — Telnyx Product Dimensions
    - `product_metrics` string[] — Telnyx Product Metrics
    - `record_types` UsageReportsRecordType[] — Subproducts if applicable
      - `record_type` string — Telnyx Product type
      - `product_dimensions` string[] — Telnyx Product Dimensions
      - `product_metrics` string[] — Telnyx Product Metrics

## Other responses

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

---

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