---
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

---

[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)