API documentation
User
Tenant
Feature
Entitlement
User & permissions
Settings
- Settings
- Media
- Webhook
- Notification
Payment
- Payment Method
- Transaction
- SEPA XML
- Open Banking
- Bank Account Transaction
Customer
- Customer
- Customer Address
- Customer Email
- Customer Settings
- Customer Otp
Billing
- Invoice
- Invoice Position Item
- Billing Run
Dunning
- Dunning Document
- Dunning Rule
Subscription
- Subscription
- Subscription Item
- Subscription Measurement
- Billing Group
Offers
- Offer
- Offer Recipient
- Offer Template
Catalogue
- Unit
- Measurement
- Product
- Product Family
- Price Plan
- Coupon
Checkout
- Checkout Link
- Cart
Accounting
Update a subscription item.
Updates the subscription item. Provided values in payload will be updated.
Required permissions:subscription:writeAuthorizations
Value for the Authorization header parameter.
Path Parameters
SubscriptionItem identifier
Body
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
255The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
5000Further information defines additional information for the item which will be displayed in the invoice.
5000The contract period terms of the subscription item. If empty, it is always cancelable.
Response
The date the subscription item was activated.
The number of intervals this discount was applied to the subscription item.
The code that can be used to apply this coupon or to use it with the api.
The frequency at which a coupon should be applied.
Possible values:
once: The coupon will be applied once for the first billing period.limited: The coupon will be applied for a limited number of billing periods.lifetime: The coupon will be applied forever.
The name of this coupon, which will be displayed to the user in the checkout process, customer front, etc.
The type of this coupon.
Possible values:
percentage: A percentage will be taken off the total plan amount.fixed_amount: A fixed amount will be taken off the total plan amount. It will never go below 0.
The plans this coupon should not be applied to.
Allow to checkout this plan. If this is set to false, the plan will not be available in the checkout and can only be assigned to a subscription by the API or in the admin panel. The plan.code is a part of the checkout url.
The code of the plan. This is used to identify the plan e.g. in the checkout url.
The description of this plan
Allow to group plans together. This allows to upgrade or downgrade between plans in the same family.
The unique identifier of the plan.
The name of this plan
The origin product this plan belongs to. This is relevant for advanced analytics.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The status of the plan.
Possible values:
draft: The plan is a draft and not available for usage in a subscription.active: The plan is active and can be used in a subscription.archived: The plan is archived and not longer available for usage in a subscription.inactive: The plan is inactive and not available for usage in a subscription.
The products this coupon should not be applied to.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
A unique code which can be used to identify the measurement.
1 - 255The unit of the measurement.
The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The date and time this coupon will expire. If null, there is no expiration date.
The fixed amount this coupon should apply. Required for type fixed_amount.
The number of billing periods the coupon will be applied for. Required for frequency limited.
The id of this coupon.
Whether this coupon is enabled or not.
The plans this coupon should be applied to.
Allow to checkout this plan. If this is set to false, the plan will not be available in the checkout and can only be assigned to a subscription by the API or in the admin panel. The plan.code is a part of the checkout url.
The code of the plan. This is used to identify the plan e.g. in the checkout url.
The description of this plan
Allow to group plans together. This allows to upgrade or downgrade between plans in the same family.
The unique identifier of the plan.
The name of this plan
The origin product this plan belongs to. This is relevant for advanced analytics.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The status of the plan.
Possible values:
draft: The plan is a draft and not available for usage in a subscription.active: The plan is active and can be used in a subscription.archived: The plan is archived and not longer available for usage in a subscription.inactive: The plan is inactive and not available for usage in a subscription.
The products this coupon should be applied to.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
A unique code which can be used to identify the measurement.
1 - 255The unit of the measurement.
The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The number of times this coupon can be redeemed in total. If null, there is no limit.
The number of times this coupon can be redeemed by a customer. If null, there is no limit.
The percentage this coupon should apply. Required for type percentage.
0 < x < 100Has this coupon been redeemed by a customer? If yes, it cannot be edited or deleted anymore.
The discount that is applied to the subscription item.
The frequency at which a coupon should be applied.
Possible values:
once: The coupon will be applied once for the first billing period.limited: The coupon will be applied for a limited number of billing periods.lifetime: The coupon will be applied forever.
The name of this coupon, which will be displayed to the user in the checkout process, customer front, etc.
The type of this coupon.
Possible values:
percentage: A percentage will be taken off the total plan amount.fixed_amount: A fixed amount will be taken off the total plan amount. It will never go below 0.
The fixed amount this coupon should apply. Required for type fixed_amount.
The number of billing periods the coupon will be applied for. Required for frequency limited.
The percentage this coupon should apply. Required for type percentage.
0 < x < 100The status of this applied discount.
Possible values:
active: The discount is active and will be applied to the subscription item.completed: The discount is not active anymore, but it was applied to the subscription item.removed: The discount was removed from the subscription item.
The billing details of the item.
The billing interval of the item. If the value is null, the item is billed only once (one-time). If the value is not null, the item is billed periodically. The value is a string in the following format: [number][unit] The unit can be one of the following: H, D, W, M, Y
The current measurement value of the item.
The date and time when the measurement was taken.
The measurement of the item.
A unique code which can be used to identify the measurement.
1 - 255The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tracked and measured quantity of the item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
Is the period inherited from the subscription?
Usage values during the subscription item period.
The date and time when the measurement was taken.
The measurement of the item.
A unique code which can be used to identify the measurement.
1 - 255The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tracked and measured quantity of the item.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The parent item of the item. If this is null, the item is a root item.
The date the subscription item was activated.
The number of intervals this discount was applied to the subscription item.
The code that can be used to apply this coupon or to use it with the api.
The frequency at which a coupon should be applied.
Possible values:
once: The coupon will be applied once for the first billing period.limited: The coupon will be applied for a limited number of billing periods.lifetime: The coupon will be applied forever.
The name of this coupon, which will be displayed to the user in the checkout process, customer front, etc.
The type of this coupon.
Possible values:
percentage: A percentage will be taken off the total plan amount.fixed_amount: A fixed amount will be taken off the total plan amount. It will never go below 0.
The plans this coupon should not be applied to.
Allow to checkout this plan. If this is set to false, the plan will not be available in the checkout and can only be assigned to a subscription by the API or in the admin panel. The plan.code is a part of the checkout url.
The code of the plan. This is used to identify the plan e.g. in the checkout url.
The description of this plan
Allow to group plans together. This allows to upgrade or downgrade between plans in the same family.
The unique identifier of the plan.
The name of this plan
The origin product this plan belongs to. This is relevant for advanced analytics.
The status of the plan.
Possible values:
draft: The plan is a draft and not available for usage in a subscription.active: The plan is active and can be used in a subscription.archived: The plan is archived and not longer available for usage in a subscription.inactive: The plan is inactive and not available for usage in a subscription.
The products this coupon should not be applied to.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The date and time this coupon will expire. If null, there is no expiration date.
The fixed amount this coupon should apply. Required for type fixed_amount.
The number of billing periods the coupon will be applied for. Required for frequency limited.
The id of this coupon.
Whether this coupon is enabled or not.
The plans this coupon should be applied to.
Allow to checkout this plan. If this is set to false, the plan will not be available in the checkout and can only be assigned to a subscription by the API or in the admin panel. The plan.code is a part of the checkout url.
The code of the plan. This is used to identify the plan e.g. in the checkout url.
The description of this plan
Allow to group plans together. This allows to upgrade or downgrade between plans in the same family.
The unique identifier of the plan.
The name of this plan
The origin product this plan belongs to. This is relevant for advanced analytics.
The status of the plan.
Possible values:
draft: The plan is a draft and not available for usage in a subscription.active: The plan is active and can be used in a subscription.archived: The plan is archived and not longer available for usage in a subscription.inactive: The plan is inactive and not available for usage in a subscription.
The products this coupon should be applied to.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The number of times this coupon can be redeemed in total. If null, there is no limit.
The number of times this coupon can be redeemed by a customer. If null, there is no limit.
The percentage this coupon should apply. Required for type percentage.
0 < x < 100Has this coupon been redeemed by a customer? If yes, it cannot be edited or deleted anymore.
The discount that is applied to the subscription item.
The frequency at which a coupon should be applied.
Possible values:
once: The coupon will be applied once for the first billing period.limited: The coupon will be applied for a limited number of billing periods.lifetime: The coupon will be applied forever.
The name of this coupon, which will be displayed to the user in the checkout process, customer front, etc.
The type of this coupon.
Possible values:
percentage: A percentage will be taken off the total plan amount.fixed_amount: A fixed amount will be taken off the total plan amount. It will never go below 0.
The fixed amount this coupon should apply. Required for type fixed_amount.
The number of billing periods the coupon will be applied for. Required for frequency limited.
The percentage this coupon should apply. Required for type percentage.
0 < x < 100The status of this applied discount.
Possible values:
active: The discount is active and will be applied to the subscription item.completed: The discount is not active anymore, but it was applied to the subscription item.removed: The discount was removed from the subscription item.
The billing details of the item.
The billing interval of the item. If the value is null, the item is billed only once (one-time). If the value is not null, the item is billed periodically. The value is a string in the following format: [number][unit] The unit can be one of the following: H, D, W, M, Y
The current measurement value of the item.
The date and time when the measurement was taken.
The measurement of the item.
A unique code which can be used to identify the measurement.
1 - 255The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tracked and measured quantity of the item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
Is the period inherited from the subscription?
Usage values during the subscription item period.
The date and time when the measurement was taken.
The measurement of the item.
A unique code which can be used to identify the measurement.
1 - 255The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tracked and measured quantity of the item.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The parent item of the item. If this is null, the item is a root item.
The date the subscription item was activated.
The number of intervals this discount was applied to the subscription item.
The code that can be used to apply this coupon or to use it with the api.
The frequency at which a coupon should be applied.
Possible values:
once: The coupon will be applied once for the first billing period.limited: The coupon will be applied for a limited number of billing periods.lifetime: The coupon will be applied forever.
The name of this coupon, which will be displayed to the user in the checkout process, customer front, etc.
The type of this coupon.
Possible values:
percentage: A percentage will be taken off the total plan amount.fixed_amount: A fixed amount will be taken off the total plan amount. It will never go below 0.
The plans this coupon should not be applied to.
The products this coupon should not be applied to.
The date and time this coupon will expire. If null, there is no expiration date.
The fixed amount this coupon should apply. Required for type fixed_amount.
The number of billing periods the coupon will be applied for. Required for frequency limited.
The id of this coupon.
Whether this coupon is enabled or not.
The plans this coupon should be applied to.
The products this coupon should be applied to.
The number of times this coupon can be redeemed in total. If null, there is no limit.
The number of times this coupon can be redeemed by a customer. If null, there is no limit.
The percentage this coupon should apply. Required for type percentage.
0 < x < 100Has this coupon been redeemed by a customer? If yes, it cannot be edited or deleted anymore.
The discount that is applied to the subscription item.
The frequency at which a coupon should be applied.
Possible values:
once: The coupon will be applied once for the first billing period.limited: The coupon will be applied for a limited number of billing periods.lifetime: The coupon will be applied forever.
The name of this coupon, which will be displayed to the user in the checkout process, customer front, etc.
The type of this coupon.
Possible values:
percentage: A percentage will be taken off the total plan amount.fixed_amount: A fixed amount will be taken off the total plan amount. It will never go below 0.
The fixed amount this coupon should apply. Required for type fixed_amount.
The number of billing periods the coupon will be applied for. Required for frequency limited.
The percentage this coupon should apply. Required for type percentage.
0 < x < 100The status of this applied discount.
Possible values:
active: The discount is active and will be applied to the subscription item.completed: The discount is not active anymore, but it was applied to the subscription item.removed: The discount was removed from the subscription item.
The billing details of the item.
The billing interval of the item. If the value is null, the item is billed only once (one-time). If the value is not null, the item is billed periodically. The value is a string in the following format: [number][unit] The unit can be one of the following: H, D, W, M, Y
The current measurement value of the item.
The date and time when the measurement was taken.
The measurement of the item.
A unique code which can be used to identify the measurement.
1 - 255The unit of the measurement.
The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tracked and measured quantity of the item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
Is the period inherited from the subscription?
Usage values during the subscription item period.
The date and time when the measurement was taken.
The measurement of the item.
A unique code which can be used to identify the measurement.
1 - 255The unit of the measurement.
The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tracked and measured quantity of the item.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The parent item of the item. If this is null, the item is a root item.
The date the subscription item was activated.
The number of intervals this discount was applied to the subscription item.
The discount that is applied to the subscription item.
The status of this applied discount.
Possible values:
active: The discount is active and will be applied to the subscription item.completed: The discount is not active anymore, but it was applied to the subscription item.removed: The discount was removed from the subscription item.
The billing details of the item.
The billing interval of the item. If the value is null, the item is billed only once (one-time). If the value is not null, the item is billed periodically. The value is a string in the following format: [number][unit] The unit can be one of the following: H, D, W, M, Y
The current measurement value of the item.
The date and time when the measurement was taken.
The measurement of the item.
The tracked and measured quantity of the item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
Is the period inherited from the subscription?
Usage values during the subscription item period.
The date and time when the measurement was taken.
The measurement of the item.
The tracked and measured quantity of the item.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The parent item of the item. If this is null, the item is a root item.
The date the subscription item was activated.
The billing details of the item.
The current measurement value of the item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
Is the period inherited from the subscription?
Usage values during the subscription item period.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The parent item of the item. If this is null, the item is a root item.
The plan this item is based on.
The price plan of the item, which defines the price and billing interval.
The product of the item.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The type of the item.
Possible values:
option: The item is an product set option.charge: The item is a charge.plan-product: The item is a plan product.product: The item is a product, and not created from a plan.
addon, charge, plan-product, product The plan this item is based on.
Allow to checkout this plan. If this is set to false, the plan will not be available in the checkout and can only be assigned to a subscription by the API or in the admin panel. The plan.code is a part of the checkout url.
The code of the plan. This is used to identify the plan e.g. in the checkout url.
The description of this plan
Allow to group plans together. This allows to upgrade or downgrade between plans in the same family.
The unique identifier of the plan.
The name of this plan
The origin product this plan belongs to. This is relevant for advanced analytics.
The status of the plan.
Possible values:
draft: The plan is a draft and not available for usage in a subscription.active: The plan is active and can be used in a subscription.archived: The plan is archived and not longer available for usage in a subscription.inactive: The plan is inactive and not available for usage in a subscription.
The price plan of the item, which defines the price and billing interval.
The price in the defined billing interval.
The type of the charge. This defines how the price is calculated.
Possible values:
flat_fee: A flat fee is charged, e.g. 10€ per month independent of the number of units.volume: A volume based price is charged, e.g. 10€ for the first 10 units and 9€ for all units when the number of units is above 10. Useful for volume discounts.percentage: A percentage of the total price is charged, e.g. 10% of the total price multiplied by the number of units. Useful for provisions.per_unit: A price per unit is charged, e.g. 10€ per unit per billing interval. Useful for per seat based pricing.tiered: A tiered price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for the next 10 units and 8€ per unit for all units above 20.stair_step: A stair step price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for all units above 10.
If this is set to true, the price plan can be applied on a trial. If the product is in trial, and this is false, the price will be charged on subscription start, otherwise after trial.
The billing interval of the price plan. If null, this is a one-time charge. Billing intervals of null cannot be prorated.
The charge related to this price plan.
If this price plan is a custom price plan. A price plan is custom if it is defined specific for a plan addon, plan charge, customer or sales channel.
The amount of free units. If null, no free units are available. Free units will be applied before passed to the price calculation and are available prorated. If the customer does not uses the free units during a billing period, they are not carried over to the next billing period. If the customer cancels the subscription before ending the billing period, the free units are only available prorated for the remaining billing period.
Example: You offer 2400 free units for 12 months and your price has a billing interval for 1 month. The customer cancels after 6 months. Only 1200 free units are available.
A price plan for a recurring product cannot have free units. Use a metered product instead.
A price plan related to a product of type charge cannot have free units.
The unique identifier of the price plan.
The internal name of the price plan.
3 - 255If this price plan is in use.
If this is set to true, the price will be charged in advance. If this is false, the price will be charged at the end of the billing interval.
The product set option related to this price plan.
If this is set to true, the price will be charged prorated when a partial billing interval is billed. This applies to measurements of type "recurring" or non-one-time billing intervals. For other measurements this parameter will be ignored.
Display the billed price per interval in customerfront or invoices. If null, the price will be shown per billing interval. Currently only available for billing intervals of months, years. Currently only allowed to show price per month (1M)
The status of the price plan.
Possible values:
active: The price is active and can be used.archived: The price is archived and cannot be used anymore. It will be not shown in any lists until explicitly requested.
The product of the item.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The type of the item.
Possible values:
option: The item is an product set option.charge: The item is a charge.plan-product: The item is a plan product.product: The item is a product, and not created from a plan.
addon, charge, plan-product, product The plan this item is based on.
Allow to checkout this plan. If this is set to false, the plan will not be available in the checkout and can only be assigned to a subscription by the API or in the admin panel. The plan.code is a part of the checkout url.
The code of the plan. This is used to identify the plan e.g. in the checkout url.
The description of this plan
Allow to group plans together. This allows to upgrade or downgrade between plans in the same family.
The unique identifier of the plan.
The name of this plan
The origin product this plan belongs to. This is relevant for advanced analytics.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The status of the plan.
Possible values:
draft: The plan is a draft and not available for usage in a subscription.active: The plan is active and can be used in a subscription.archived: The plan is archived and not longer available for usage in a subscription.inactive: The plan is inactive and not available for usage in a subscription.
The price plan of the item, which defines the price and billing interval.
The price in the defined billing interval.
The amount of the flat fee per unit
The date and time when the resource was created.
The date and time when the resource was last updated.
The type of the charge. This defines how the price is calculated.
Possible values:
flat_fee: A flat fee is charged, e.g. 10€ per month independent of the number of units.volume: A volume based price is charged, e.g. 10€ for the first 10 units and 9€ for all units when the number of units is above 10. Useful for volume discounts.percentage: A percentage of the total price is charged, e.g. 10% of the total price multiplied by the number of units. Useful for provisions.per_unit: A price per unit is charged, e.g. 10€ per unit per billing interval. Useful for per seat based pricing.tiered: A tiered price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for the next 10 units and 8€ per unit for all units above 20.stair_step: A stair step price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for all units above 10.
If this is set to true, the price plan can be applied on a trial. If the product is in trial, and this is false, the price will be charged on subscription start, otherwise after trial.
The billing interval of the price plan. If null, this is a one-time charge. Billing intervals of null cannot be prorated.
The charge related to this price plan.
The unique identifier of the plan product.
Whether the charge should only be applied once on the event. Defaults to false.
The event on which the charge should be applied. Defaults to ON_SUBSCRIPTION_START.
Possible values:
on_subscription_start: The charge is applied when the subscription starts.on_subscription_end: The charge is applied when the subscription ends.on_subscription_trial_start: The charge is applied when the subscription trial starts.on_subscription_trial_end: The charge is applied when the subscription trial ends.on_checkout_payment: The charge is applied when the checkout payment is made.
The product this addon belongs to.
If this price plan is a custom price plan. A price plan is custom if it is defined specific for a plan addon, plan charge, customer or sales channel.
The amount of free units. If null, no free units are available. Free units will be applied before passed to the price calculation and are available prorated. If the customer does not uses the free units during a billing period, they are not carried over to the next billing period. If the customer cancels the subscription before ending the billing period, the free units are only available prorated for the remaining billing period.
Example: You offer 2400 free units for 12 months and your price has a billing interval for 1 month. The customer cancels after 6 months. Only 1200 free units are available.
A price plan for a recurring product cannot have free units. Use a metered product instead.
A price plan related to a product of type charge cannot have free units.
The unique identifier of the price plan.
The internal name of the price plan.
3 - 255If this price plan is in use.
If this is set to true, the price will be charged in advance. If this is false, the price will be charged at the end of the billing interval.
If this is set to true, the price will be charged prorated when a partial billing interval is billed. This applies to measurements of type "recurring" or non-one-time billing intervals. For other measurements this parameter will be ignored.
Display the billed price per interval in customerfront or invoices. If null, the price will be shown per billing interval. Currently only available for billing intervals of months, years. Currently only allowed to show price per month (1M)
The status of the price plan.
Possible values:
active: The price is active and can be used.archived: The price is archived and cannot be used anymore. It will be not shown in any lists until explicitly requested.
The product of the item.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
A unique code which can be used to identify the measurement.
1 - 255The unit of the measurement.
The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The type of the item.
Possible values:
option: The item is an product set option.charge: The item is a charge.plan-product: The item is a plan product.product: The item is a product, and not created from a plan.
addon, charge, plan-product, product The plan this item is based on.
Allow to checkout this plan. If this is set to false, the plan will not be available in the checkout and can only be assigned to a subscription by the API or in the admin panel. The plan.code is a part of the checkout url.
The code of the plan. This is used to identify the plan e.g. in the checkout url.
The description of this plan
Allow to group plans together. This allows to upgrade or downgrade between plans in the same family.
The unique identifier of the plan.
The name of this plan
The origin product this plan belongs to. This is relevant for advanced analytics.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
A unique code which can be used to identify the measurement.
1 - 255The unit of the measurement.
The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The status of the plan.
Possible values:
draft: The plan is a draft and not available for usage in a subscription.active: The plan is active and can be used in a subscription.archived: The plan is archived and not longer available for usage in a subscription.inactive: The plan is inactive and not available for usage in a subscription.
The price plan of the item, which defines the price and billing interval.
The price in the defined billing interval.
The type of the charge. This defines how the price is calculated.
Possible values:
flat_fee: A flat fee is charged, e.g. 10€ per month independent of the number of units.volume: A volume based price is charged, e.g. 10€ for the first 10 units and 9€ for all units when the number of units is above 10. Useful for volume discounts.percentage: A percentage of the total price is charged, e.g. 10% of the total price multiplied by the number of units. Useful for provisions.per_unit: A price per unit is charged, e.g. 10€ per unit per billing interval. Useful for per seat based pricing.tiered: A tiered price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for the next 10 units and 8€ per unit for all units above 20.stair_step: A stair step price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for all units above 10.
If this is set to true, the price plan can be applied on a trial. If the product is in trial, and this is false, the price will be charged on subscription start, otherwise after trial.
The billing interval of the price plan. If null, this is a one-time charge. Billing intervals of null cannot be prorated.
The charge related to this price plan.
The unique identifier of the plan product.
Whether the charge should only be applied once on the event. Defaults to false.
The event on which the charge should be applied. Defaults to ON_SUBSCRIPTION_START.
Possible values:
on_subscription_start: The charge is applied when the subscription starts.on_subscription_end: The charge is applied when the subscription ends.on_subscription_trial_start: The charge is applied when the subscription trial starts.on_subscription_trial_end: The charge is applied when the subscription trial ends.on_checkout_payment: The charge is applied when the checkout payment is made.
The product this addon belongs to.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
If this price plan is a custom price plan. A price plan is custom if it is defined specific for a plan addon, plan charge, customer or sales channel.
The amount of free units. If null, no free units are available. Free units will be applied before passed to the price calculation and are available prorated. If the customer does not uses the free units during a billing period, they are not carried over to the next billing period. If the customer cancels the subscription before ending the billing period, the free units are only available prorated for the remaining billing period.
Example: You offer 2400 free units for 12 months and your price has a billing interval for 1 month. The customer cancels after 6 months. Only 1200 free units are available.
A price plan for a recurring product cannot have free units. Use a metered product instead.
A price plan related to a product of type charge cannot have free units.
The unique identifier of the price plan.
The internal name of the price plan.
3 - 255If this price plan is in use.
If this is set to true, the price will be charged in advance. If this is false, the price will be charged at the end of the billing interval.
The product set option related to this price plan.
The unique identifier of the product set option.
The product this option belongs to.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
If this is set to true, the price will be charged prorated when a partial billing interval is billed. This applies to measurements of type "recurring" or non-one-time billing intervals. For other measurements this parameter will be ignored.
Display the billed price per interval in customerfront or invoices. If null, the price will be shown per billing interval. Currently only available for billing intervals of months, years. Currently only allowed to show price per month (1M)
The status of the price plan.
Possible values:
active: The price is active and can be used.archived: The price is archived and cannot be used anymore. It will be not shown in any lists until explicitly requested.
The product of the item.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
A unique code which can be used to identify the measurement.
1 - 255The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The type of the item.
Possible values:
option: The item is an product set option.charge: The item is a charge.plan-product: The item is a plan product.product: The item is a product, and not created from a plan.
addon, charge, plan-product, product The plan this item is based on.
Allow to checkout this plan. If this is set to false, the plan will not be available in the checkout and can only be assigned to a subscription by the API or in the admin panel. The plan.code is a part of the checkout url.
The code of the plan. This is used to identify the plan e.g. in the checkout url.
The description of this plan
Allow to group plans together. This allows to upgrade or downgrade between plans in the same family.
The unique identifier of the plan.
The name of this plan
The origin product this plan belongs to. This is relevant for advanced analytics.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
A unique code which can be used to identify the measurement.
1 - 255The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The status of the plan.
Possible values:
draft: The plan is a draft and not available for usage in a subscription.active: The plan is active and can be used in a subscription.archived: The plan is archived and not longer available for usage in a subscription.inactive: The plan is inactive and not available for usage in a subscription.
The price plan of the item, which defines the price and billing interval.
The price in the defined billing interval.
The type of the charge. This defines how the price is calculated.
Possible values:
flat_fee: A flat fee is charged, e.g. 10€ per month independent of the number of units.volume: A volume based price is charged, e.g. 10€ for the first 10 units and 9€ for all units when the number of units is above 10. Useful for volume discounts.percentage: A percentage of the total price is charged, e.g. 10% of the total price multiplied by the number of units. Useful for provisions.per_unit: A price per unit is charged, e.g. 10€ per unit per billing interval. Useful for per seat based pricing.tiered: A tiered price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for the next 10 units and 8€ per unit for all units above 20.stair_step: A stair step price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for all units above 10.
If this is set to true, the price plan can be applied on a trial. If the product is in trial, and this is false, the price will be charged on subscription start, otherwise after trial.
The billing interval of the price plan. If null, this is a one-time charge. Billing intervals of null cannot be prorated.
The charge related to this price plan.
The unique identifier of the plan product.
Whether the charge should only be applied once on the event. Defaults to false.
The event on which the charge should be applied. Defaults to ON_SUBSCRIPTION_START.
Possible values:
on_subscription_start: The charge is applied when the subscription starts.on_subscription_end: The charge is applied when the subscription ends.on_subscription_trial_start: The charge is applied when the subscription trial starts.on_subscription_trial_end: The charge is applied when the subscription trial ends.on_checkout_payment: The charge is applied when the checkout payment is made.
The product this addon belongs to.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
A unique code which can be used to identify the measurement.
1 - 255The unit of the measurement.
The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
If this price plan is a custom price plan. A price plan is custom if it is defined specific for a plan addon, plan charge, customer or sales channel.
The amount of free units. If null, no free units are available. Free units will be applied before passed to the price calculation and are available prorated. If the customer does not uses the free units during a billing period, they are not carried over to the next billing period. If the customer cancels the subscription before ending the billing period, the free units are only available prorated for the remaining billing period.
Example: You offer 2400 free units for 12 months and your price has a billing interval for 1 month. The customer cancels after 6 months. Only 1200 free units are available.
A price plan for a recurring product cannot have free units. Use a metered product instead.
A price plan related to a product of type charge cannot have free units.
The unique identifier of the price plan.
The internal name of the price plan.
3 - 255If this price plan is in use.
If this is set to true, the price will be charged in advance. If this is false, the price will be charged at the end of the billing interval.
The product set option related to this price plan.
The unique identifier of the product set option.
The product this option belongs to.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
A unique code which can be used to identify the measurement.
1 - 255The unit of the measurement.
The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
If this is set to true, the price will be charged prorated when a partial billing interval is billed. This applies to measurements of type "recurring" or non-one-time billing intervals. For other measurements this parameter will be ignored.
Display the billed price per interval in customerfront or invoices. If null, the price will be shown per billing interval. Currently only available for billing intervals of months, years. Currently only allowed to show price per month (1M)
The status of the price plan.
Possible values:
active: The price is active and can be used.archived: The price is archived and cannot be used anymore. It will be not shown in any lists until explicitly requested.
The product of the item.
The measurement that is used for the price plan. This could define the quantity or a metered usage.
A unique code which can be used to identify the measurement.
1 - 255The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.sum: The sum of all sent measurements in the billing interval.last_value: The last sent measurement.average: The average of all sent measurements in the billing interval.
A description of the measurement, which is shown in the summary of the usage data in the invoice.
255If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.
A unique identifier for the measurement.
The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.
Possible values:
instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".metered: The measurement value is reset to 0 after each billing interval.recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".
The tax group that is used for the product.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan The cost centre is used for accounting exports.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The type of the item.
Possible values:
option: The item is an product set option.charge: The item is a charge.plan-product: The item is a plan product.product: The item is a product, and not created from a plan.
addon, charge, plan-product, product Was this page helpful?