---
title: "Get monthly charges summary"
method: GET
path: "/charges_summary"
---

# Get monthly charges summary

`GET /charges_summary`

Retrieve a summary of monthly charges for a specified date range. The date range cannot exceed 31 days.

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required

## Response `200`

Monthly charges summary

- MonthlyChargesSummaryResponse
  - `data` SummaryAndTotal, required
    - `user_id` string, required — User identifier
    - `start_date` string, date, required — Start date of the summary period
    - `end_date` string, date, required — End date of the summary period
    - `user_email` string, email, required — User email address
    - `currency` string, required — Currency code
    - `summary` Summary, required
      - `lines` SummaryLine[], required — List of charge summary lines
        - union
          - ComparativeLine
            - `type` 'comparative', required
            - `name` string, required — Service name
            - `alias` string, required — Service alias
            - `new_this_month` MonthDetail, required
              - …
            - `existing_this_month` MonthDetail, required
              - …
          - SimpleLine
            - `type` 'simple', required
            - `name` string, required — Service name
            - `alias` string, required — Service alias
            - `quantity` integer, required — Number of items
            - `amount` string, required — Total amount as decimal string
      - `adjustments` AdjustmentLine[], required — List of billing adjustments
        - `amount` string, required — Adjustment amount as decimal string
        - `description` string, required — Description of the adjustment
        - `event_date` string, date, required — Date when the adjustment occurred
    - `total` TotalSummary, required
      - `new_mrc` string, required — Total new monthly recurring charges as decimal string
      - `new_otc` string, required — Total new one-time charges as decimal string
      - `existing_mrc` string, required — Total existing monthly recurring charges as decimal string
      - `other` string, required — Other charges as decimal string
      - `credits` string, required — Total credits as decimal string
      - `ledger_adjustments` string, required — Ledger adjustments as decimal string
      - `grand_total` string, required — Grand total of all charges as decimal string

## Other responses

- `400` — Invalid request parameters or date range
- `422` — User account not found
- `default` — Unexpected error

## Changes

> 81 revisions in range; 1 not diffed.

- **2026-08-17** `1571b0380bd7` — 3 breaking
  - the response's body type changed from `object` to no type for status `default`
  - the `errors/items/` response's property type changed from `object` to no type for status `default`
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to `integer` for status `default`
- **2026-08-04** `8f5f4e537994` — 4 breaking
  - the response's body type changed from no type to `object` for status `default`
  - the `errors/items/` response's property type changed from no type to `object` for status `default`
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from `integer` to `int32` for status `default`
  - the `errors/items/source/pointer` response's property format changed from `json-pointer` to no format for status `default`

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/charges_summary/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f6e9ed754d05?raw)