Skip to main content
GET
List a plan's usage charges
Returns every usage charge configured on a plan — one per billable metric — with the metric embedded so a consumer can render pricing without a second lookup. Charges are the usage-priced half of a plan; flat recurring prices stay on the plan itself (see Get a Plan). To replace the set use Set Plan Charges; to preview what a charge set would bill against sample usage use Simulate Charges. Usage is billed in arrears at period close unless a charge sets pay_in_advance, in which case each event is rated at ingestion and captured as an unbilled charge for the next invoice.

Parameters

Example Request

Response

An empty plan returns {"data": []}.

Fields

amounts by charge model

Errors

Errors use the standard envelope — see Errors.

Authorizations

Authorization
string
header
required

Tenant API key obtained from POST /auth/register or POST /v1/developer/keys.

Path Parameters

id
string<uuid>
required

Response

The plan's charges with metrics joined

data
object[]