---
title: "Get customer invoice summary"
method: GET
path: "/customers/{id}/invoices/summary"
tags: ["Invoices"]
---

# Get customer invoice summary

`GET /customers/{id}/invoices/summary`

Use when showing a customer's invoice overview (e.g. billing portal or balance summary). Includes totals and multi-currency breakdown.

## Path parameters

- `id` string, required

## Response `200`

OK

- CustomerMultiCurrencyInvoiceSummary
  - `customer_id` string — customer_id is the unique identifier of the customer
  - `default_currency` string — default_currency is the primary currency for this customer
  - `summaries` CustomerInvoiceSummary[] — summaries contains the invoice summaries for each currency
    - `currency` string — currency is the three-letter ISO currency code for this summary
    - `customer_id` string — customer_id is the unique identifier of the customer
    - `overdue_invoice_count` integer — overdue_invoice_count is the number of overdue invoices for this customer in this currency
    - `total_invoice_count` integer — total_invoice_count is the total number of invoices for this customer in this currency
    - `total_overdue_amount` string — total_overdue_amount is the total amount of overdue invoices in this currency
    - `total_revenue_amount` string — total_revenue_amount is the total revenue generated from this customer in this currency
    - `total_unpaid_amount` string — total_unpaid_amount is the total amount of unpaid invoices in this currency
    - `unpaid_fixed_charges` string — unpaid_fixed_charges is the total amount of unpaid fixed charges in this currency
    - `unpaid_invoice_count` integer — unpaid_invoice_count is the number of unpaid invoices for this customer in this currency
    - `unpaid_usage_charges` string — unpaid_usage_charges is the total amount of unpaid usage-based charges in this currency

## Other responses

- `400` — Invalid request
- `500` — Server error

---

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