API Metering plan management
List plans
⚠️ Preview: The Metering APIs are in preview and subject to change.
List all plans.
path Parameters
bucketIdThe id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.
query Parameters
includeDeletedInclude deleted plans in response.
Usage: ?includeDeleted=true
idFilter by plan.id attribute
keyFilter by plan.key attribute
Filter by plan.key and plan.version attributes
statusOnly return plans with the given status.
Usage:
?status=active: return only the currently active plan?status=draft: return only the draft plan?status=archived: return only the archived plans
currencyFilter by plan.currency attribute
pagePage index.
Default is 1.
pageSizeThe maximum number of items per page.
Default is 100.
orderThe order direction.
The order direction.
orderByThe order by field.
Order by options for plans.
List plans › Responses
The request has succeeded.
totalCountThe total number of items.
pageThe page index.
pageSizeThe maximum number of items per page.
The items in the current page.
Create a plan
⚠️ Preview: The Metering APIs are in preview and subject to change.
Create a new plan.
path Parameters
bucketIdThe id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.
Create a plan › Request Body
nameHuman-readable name for the resource. Between 1 and 256 characters.
key^[a-z0-9]+(?:_[a-z0-… · requiredA semi-unique identifier for the resource.
currency^[A-Z]{3}$ · requiredThree-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.
billingCadenceThe default billing cadence for subscriptions using this plan. Defines how often customers are billed using ISO8601 duration format. Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses. A phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices.
descriptionOptional description of the resource. Maximum 1024 characters.
Set of key-value pairs. Metadata can be used to store additional information about a resource.
Configuration for pro-rating behavior.
Alignment configuration for a plan or subscription.
Create a plan › Responses
The request has succeeded and a new resource has been created as a result.
id^[0-7][0-9A-HJKMNP-T… · requiredA unique identifier for the resource.
nameHuman-readable name for the resource. Between 1 and 256 characters.
createdAtTimestamp of when the resource was created.
updatedAtTimestamp of when the resource was last updated.
key^[a-z0-9]+(?:_[a-z0-… · requiredA semi-unique identifier for the resource.
versionVersion of the plan. Incremented when the plan is updated.
currency^[A-Z]{3}$ · requiredThree-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.
billingCadenceThe default billing cadence for subscriptions using this plan. Defines how often customers are billed using ISO8601 duration format. Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
statusThe status of a plan.
The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses. A phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices.
List of validation errors.
descriptionOptional description of the resource. Maximum 1024 characters.
Set of key-value pairs. Metadata can be used to store additional information about a resource.
deletedAtTimestamp of when the resource was permanently deleted.
Configuration for pro-rating behavior.
effectiveFromThe date and time when the plan becomes effective. When not specified, the plan is a draft.
effectiveToThe date and time when the plan is no longer effective. When not specified, the plan is effective indefinitely.
Alignment configuration for a plan or subscription.
New draft plan
⚠️ Preview: The Metering APIs are in preview and subject to change.
Create a new draft version from plan. It returns error if there is already a plan in draft or planId does not reference the latest published version.
path Parameters
bucketIdThe id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.
planIdOrKey^[a-z0-9]+(?:_[a-z0-… · requiredNew draft plan › Responses
The request has succeeded and a new resource has been created as a result.
id^[0-7][0-9A-HJKMNP-T… · requiredA unique identifier for the resource.
nameHuman-readable name for the resource. Between 1 and 256 characters.
createdAtTimestamp of when the resource was created.
updatedAtTimestamp of when the resource was last updated.
key^[a-z0-9]+(?:_[a-z0-… · requiredA semi-unique identifier for the resource.
versionVersion of the plan. Incremented when the plan is updated.
currency^[A-Z]{3}$ · requiredThree-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.
billingCadenceThe default billing cadence for subscriptions using this plan. Defines how often customers are billed using ISO8601 duration format. Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
statusThe status of a plan.
The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses. A phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices.
List of validation errors.
descriptionOptional description of the resource. Maximum 1024 characters.
Set of key-value pairs. Metadata can be used to store additional information about a resource.
deletedAtTimestamp of when the resource was permanently deleted.
Configuration for pro-rating behavior.
effectiveFromThe date and time when the plan becomes effective. When not specified, the plan is a draft.
effectiveToThe date and time when the plan is no longer effective. When not specified, the plan is effective indefinitely.
Alignment configuration for a plan or subscription.
Get plan
⚠️ Preview: The Metering APIs are in preview and subject to change.
Get a plan by id or key. The latest published version is returned if latter is used.
path Parameters
bucketIdThe id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.
planId^[a-z0-9]+(?:_[a-z0-… · requiredquery Parameters
includeLatestInclude latest version of the Plan instead of the version in active state.
Usage: ?includeLatest=true
Get plan › Responses
The request has succeeded.
id^[0-7][0-9A-HJKMNP-T… · requiredA unique identifier for the resource.
nameHuman-readable name for the resource. Between 1 and 256 characters.
createdAtTimestamp of when the resource was created.
updatedAtTimestamp of when the resource was last updated.
key^[a-z0-9]+(?:_[a-z0-… · requiredA semi-unique identifier for the resource.
versionVersion of the plan. Incremented when the plan is updated.
currency^[A-Z]{3}$ · requiredThree-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.
billingCadenceThe default billing cadence for subscriptions using this plan. Defines how often customers are billed using ISO8601 duration format. Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
statusThe status of a plan.
The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses. A phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices.
List of validation errors.
descriptionOptional description of the resource. Maximum 1024 characters.
Set of key-value pairs. Metadata can be used to store additional information about a resource.
deletedAtTimestamp of when the resource was permanently deleted.
Configuration for pro-rating behavior.
effectiveFromThe date and time when the plan becomes effective. When not specified, the plan is a draft.
effectiveToThe date and time when the plan is no longer effective. When not specified, the plan is effective indefinitely.
Alignment configuration for a plan or subscription.
Update a plan
⚠️ Preview: The Metering APIs are in preview and subject to change.
Update plan by id.
path Parameters
bucketIdThe id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.
planId^[0-7][0-9A-HJKMNP-T… · requiredUpdate a plan › Request Body
nameHuman-readable name for the resource. Between 1 and 256 characters.
billingCadenceThe default billing cadence for subscriptions using this plan. Defines how often customers are billed using ISO8601 duration format. Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses. A phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices.
descriptionOptional description of the resource. Maximum 1024 characters.
Set of key-value pairs. Metadata can be used to store additional information about a resource.
Configuration for pro-rating behavior.
Alignment configuration for a plan or subscription.
Update a plan › Responses
The request has succeeded.
id^[0-7][0-9A-HJKMNP-T… · requiredA unique identifier for the resource.
nameHuman-readable name for the resource. Between 1 and 256 characters.
createdAtTimestamp of when the resource was created.
updatedAtTimestamp of when the resource was last updated.
key^[a-z0-9]+(?:_[a-z0-… · requiredA semi-unique identifier for the resource.
versionVersion of the plan. Incremented when the plan is updated.
currency^[A-Z]{3}$ · requiredThree-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.
billingCadenceThe default billing cadence for subscriptions using this plan. Defines how often customers are billed using ISO8601 duration format. Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
statusThe status of a plan.
The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses. A phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices.
List of validation errors.
descriptionOptional description of the resource. Maximum 1024 characters.
Set of key-value pairs. Metadata can be used to store additional information about a resource.
deletedAtTimestamp of when the resource was permanently deleted.
Configuration for pro-rating behavior.
effectiveFromThe date and time when the plan becomes effective. When not specified, the plan is a draft.
effectiveToThe date and time when the plan is no longer effective. When not specified, the plan is effective indefinitely.
Alignment configuration for a plan or subscription.
Delete plan
⚠️ Preview: The Metering APIs are in preview and subject to change.
Soft delete plan by plan.id.
Once a plan is deleted it cannot be undeleted.
path Parameters
bucketIdThe id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.
planId^[0-7][0-9A-HJKMNP-T… · requiredDelete plan › Responses
There is no content to send for this request, but the headers may be useful.
Archive plan version
⚠️ Preview: The Metering APIs are in preview and subject to change.
Archive a plan version.
path Parameters
bucketIdThe id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.
planId^[0-7][0-9A-HJKMNP-T… · requiredArchive plan version › Responses
The request has succeeded.
id^[0-7][0-9A-HJKMNP-T… · requiredA unique identifier for the resource.
nameHuman-readable name for the resource. Between 1 and 256 characters.
createdAtTimestamp of when the resource was created.
updatedAtTimestamp of when the resource was last updated.
key^[a-z0-9]+(?:_[a-z0-… · requiredA semi-unique identifier for the resource.
versionVersion of the plan. Incremented when the plan is updated.
currency^[A-Z]{3}$ · requiredThree-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.
billingCadenceThe default billing cadence for subscriptions using this plan. Defines how often customers are billed using ISO8601 duration format. Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
statusThe status of a plan.
The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses. A phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices.
List of validation errors.
descriptionOptional description of the resource. Maximum 1024 characters.
Set of key-value pairs. Metadata can be used to store additional information about a resource.
deletedAtTimestamp of when the resource was permanently deleted.
Configuration for pro-rating behavior.
effectiveFromThe date and time when the plan becomes effective. When not specified, the plan is a draft.
effectiveToThe date and time when the plan is no longer effective. When not specified, the plan is effective indefinitely.
Alignment configuration for a plan or subscription.
Publish plan
⚠️ Preview: The Metering APIs are in preview and subject to change.
Publish a plan version.
path Parameters
bucketIdThe id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.
planId^[0-7][0-9A-HJKMNP-T… · requiredPublish plan › Responses
The request has succeeded.
id^[0-7][0-9A-HJKMNP-T… · requiredA unique identifier for the resource.
nameHuman-readable name for the resource. Between 1 and 256 characters.
createdAtTimestamp of when the resource was created.
updatedAtTimestamp of when the resource was last updated.
key^[a-z0-9]+(?:_[a-z0-… · requiredA semi-unique identifier for the resource.
versionVersion of the plan. Incremented when the plan is updated.
currency^[A-Z]{3}$ · requiredThree-letter ISO4217 currency code. Custom three-letter currency codes are also supported for convenience.
billingCadenceThe default billing cadence for subscriptions using this plan. Defines how often customers are billed using ISO8601 duration format. Examples: "P1M" (monthly), "P3M" (quarterly), "P1Y" (annually).
statusThe status of a plan.
The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses. A phase switch occurs only at the end of a billing period, ensuring that a single subscription invoice will not include charges from different phase prices.
List of validation errors.
descriptionOptional description of the resource. Maximum 1024 characters.
Set of key-value pairs. Metadata can be used to store additional information about a resource.
deletedAtTimestamp of when the resource was permanently deleted.
Configuration for pro-rating behavior.
effectiveFromThe date and time when the plan becomes effective. When not specified, the plan is a draft.
effectiveToThe date and time when the plan is no longer effective. When not specified, the plan is effective indefinitely.
Alignment configuration for a plan or subscription.