---
title: "Get monthly charges breakdown"
method: GET
path: "/charges_breakdown"
---

# Get monthly charges breakdown

`GET /charges_breakdown`

Retrieve a detailed breakdown of monthly charges for phone numbers in a specified date range. The date range cannot exceed 31 days.

## Query parameters

- `start_date` string, date, required
- `end_date` string, date
- `format` 'json' | 'csv'

## Response `200`

Monthly charges breakdown

- MonthlyChargesBreakdownResponse
  - `data` BreakdownData, required
    - `currency` string, required — Currency code
    - `end_date` string, date, required — End date of the breakdown period
    - `results` NumberBreakdownResult[], required — List of phone number charge breakdowns
      - `charge_type` string, required — Type of charge for the number
      - `service_owner_email` string, email, required — Email address of the service owner
      - `service_owner_user_id` string, required — User ID of the service owner
      - `services` ServiceDetail[], required — List of services associated with this number
        - `cost` string, required — Cost per unit as decimal string
        - `cost_type` string, required — Type of cost (MRC or OTC)
        - `name` string, required — Service name
      - `tn` string, required — Phone number
    - `start_date` string, date, required — Start date of the breakdown period
    - `user_email` string, email, required — User email address
    - `user_id` string, required — User identifier

## Other responses

- `400` — Invalid request parameters or date range
- `422` — User account not found
- `default` — Unexpected 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/revisions/ec31f78cf002/schema)