Manage Subscriptions via APIs

Introduction

This article explains how to Manage Subscriptions via APIs. This will unlock the integration scenario in which you can collect subscription data and manage subscriptions in your ERP/CRM and/or marketplace.

APIs in scope:

No.1. List all Subscriptions

Get all subscriptions associated with the selected customer. The API will return both enabled and disabled subscriptions.

No.2. Retrieve a subscription

Get detailed information on the selected subscription.

No.2.1. List add-ons for subscription

Get detailed information about add-ons associated with a specific subscription. It eliminates the need for manual searching or querying multiple sources, enabling a streamlined process for retrieving add-on details. Details include:

1. Id: A unique identifier for the addon subscription. Id is used as "SubscriptionId" when updating a subscription.
2. OfferId: The identifier for the offer associated with the addon.
3. Quantity: The quantity of the addon.
4. SubscriptionState: The state of the subscription (e.g., Enabled, Disabled).
5. Name: The name of the addon.
6. MeterName: The meter name associated with the addon.
7. MinAmount: The minimum quantity allowed for the addon.
8. MaxAmount: The maximum quantity allowed for the addon.
9. OfferType: The addon's offer type (e.g., LicenceBasedSubscription).
10. IsOffer: Indicates whether the addon is an offer.
11. IsCpq: Indicates whether the addon is subject to CPQ (Configure Price Quote) form. If true, you can retrieve a pricing plan for such an add-on by using "Retrieve a pricing plan for the offer".
12. VendorId: The identifier for the vendor associated with the addon.
13. OfferConfigurationType: The configuration type of the offer for the addon (e.g., ManualQuantityOnly).

No.3. Update a subscription

Updates a subscription based on the available configuration, including, but not limited to changing the subscription quantity, billing cycle (monthly, annual), and term.

Please note that offers can have different compatibility rules, post-purchase restrictions, and billing cycle settings. For example, for some offers, you are unable to reduce the quantity, or change the billing cycle, whereas others can be canceled only within a specific time frame. As a result, when you're building an integration please consider the individual offer logic specified in the offer pricing plan. The pricing plan can be retrieved by using Retrieve a pricing plan for the offer.