---
title: "List charges for a plan"
method: GET
path: "/api/charges/plan/{planId}"
tags: ["Charges"]
---

# List charges for a plan

`GET /api/charges/plan/{planId}`

Retrieve all charges attached to a specific plan.

## Path parameters

- `planId` string, required

## Response `200`

List of charges for the plan

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