---
title: "List all charges"
method: GET
path: "/api/charges"
tags: ["Charges"]
---

# List all charges

`GET /api/charges`

Retrieve all charges, optionally filtered by plan ID.

## Query parameters

- `planId` string

## Response `200`

List of charges

- ChargeResponse[]
  - `id` string, required
  - `planId` string, required
  - `billableMetricId` string, required
  - `chargeModel` 'STANDARD' | 'GRADUATED' | 'VOLUME' | 'PACKAGE' | 'PERCENTAGE', required
  - `billingTiming` 'IN_ADVANCE' | 'IN_ARREARS', required
  - `invoiceDisplayName` string
  - `minAmountCents` number
  - `prorated` boolean, required
  - `properties` object — Model-specific config
  - `graduatedRanges` ChargeGraduatedRangeResponse[], required
    - `id` string, required
    - `chargeId` string, required
    - `fromValue` number, required
    - `toValue` number
    - `perUnitAmount` string, required — Per-unit amount as decimal string
    - `flatAmount` string, required — Flat fee for this range
    - `order` number, required
  - `filters` ChargeFilterResponse[], required
    - `id` string, required
    - `chargeId` string, required
    - `key` string, required
    - `values` string[], required
    - `properties` object
  - `createdAt` string, required
  - `updatedAt` string, required

---

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