Skip to main content
POST
/
api
/
v1
/
plans
/
{plan_id}
/
charges
Add Charge to Plan
curl --request POST \
  --url https://api.example.com/api/v1/plans/{plan_id}/charges \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "unit_price": 123,
  "meter_id": "<string>",
  "display_name": "<string>"
}
'
{
  "id": "...",
  "type": "USAGE",
  "meter_id": "...",
  "unit_price": 0.001,
  "display_name": "API calls",
  "status": "ACTIVE",
  "created_at": "2025-01-01T00:00:00Z"
}
​
plan_id
string
required
UUID of the plan
​
type
string
required
Charge type: FIXED or USAGE
​
unit_price
number
required
Price per unit (USAGE) or flat amount (FIXED)
​
meter_id
string
Required for USAGE charges — the meter to bill against
​
display_name
string
How this charge appears on invoices
{
  "id": "...",
  "type": "USAGE",
  "meter_id": "...",
  "unit_price": 0.001,
  "display_name": "API calls",
  "status": "ACTIVE",
  "created_at": "2025-01-01T00:00:00Z"
}