Skip to main content
POST
Publish a draft plan version

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

plan_id
string<MeteroidId>
required

Plan ID

Example:

"plan_7n42DGM5Tflk9n8mt7Fhc7"

Response

Plan published

available_parameters
object
required
created_at
string<date-time>
required
currency
string
required
id
string<MeteroidId>
required
Example:

"plan_7n42DGM5Tflk9n8mt7Fhc7"

name
string
required
net_terms
integer<int32>
required
plan_type
enum<string>
required
Available options:
STANDARD,
FREE,
CUSTOM
price_components
object[]
required
product_family
object
required
status
enum<string>
required
Available options:
DRAFT,
ACTIVE,
INACTIVE,
ARCHIVED
tax_inclusive
boolean
required

The plan's amounts are quoted tax-included ("9.99 incl. VAT"): tax is carved out of them at invoice time instead of being added on top, so the customer pays the quoted price whatever rate applies. A customer who bears no tax (reverse charge, exempt, export) still pays it in full. Defaults to false.

version
integer<int32>
required
version_id
string<MeteroidId>
required
Example:

"plv_7n42DGM5Tflk9n8mt7Fhc7"

billing_cycles
integer<int32> | null
description
string | null
entitlements
object[]
minimum_commitment
object | null

Plan-level minimum commitment (period true-up floor). When set, every billing-period invoice for this plan is guaranteed to be at least minimum_commitment.amount after discounts, with a "Minimum commitment" line filling any shortfall.

period_start_day
integer<int32> | null
self_service_rank
integer<int32> | null
trial
object | null