Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zuora Subscriptions API

A subscription is a product or service that has recurring charges, such as a monthly flat fee or charges based on usage. Subscriptions can also include one-time charges, such as activation fees. Every subscription must be associated with an account. At least one active account must exist before any subscriptions can be created.For more information, see Subscriptions.

Zuora Subscriptions API is one of 80 APIs that Zuora publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Subscriptions. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 12 operations across 11 paths, and defines 56 schemas. It is described by OpenAPI 2.0, at version 2023-12-15.

12 operations 11 paths 56 schemas 3 GET2 POST7 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
2023-12-15
Resource Areas
1

Paths & Operations 12

Across 11 paths, the API surfaces 12 operations — 3 GET, 2 POST, 7 PUT. Each is listed below with its method, path, parameters, and response codes.

Subscriptions 12

A subscription is a product or service that has recurring charges, such as a monthly flat fee or charges based on usage. Subscriptions can also include one-time charges, such as a…

POST
/v1/subscriptions/preview
Preview a subscription
POST_PreviewSubscription 9 params → 200
POST
/v1/subscriptions
Create a subscription
POST_Subscription 9 params → 200
GET
/v1/subscriptions/accounts/{account-key}
List subscriptions by account key
GET_SubscriptionsByAccount 11 params → 200
PUT
/v1/subscriptions/{subscription-key}
Update a subscription
PUT_Subscription 9 params → 200
GET
/v1/subscriptions/{subscription-key}
Retrieve a subscription by key
GET_SubscriptionsByKey 9 params → 200
GET
/v1/subscriptions/{subscription-key}/versions/{version}
Retrieve a subscription by key and version
GET_SubscriptionsByKeyAndVersion 10 params → 200
PUT
/v1/subscriptions/{subscription-key}/renew
Renew a subscription
PUT_RenewSubscription 9 params → 200
PUT
/v1/subscriptions/{subscription-key}/cancel
Cancel a subscription
PUT_CancelSubscription 9 params → 200
PUT
/v1/subscriptions/{subscription-key}/resume
Resume a subscription
PUT_ResumeSubscription 9 params → 200
PUT
/v1/subscriptions/{subscription-key}/suspend
Suspend a subscription
PUT_SuspendSubscription 9 params → 200
PUT
/v1/subscriptions/{subscription-key}/delete
Delete a subscription by number
PUT_DeleteSubscription 7 params → 200
PUT
/v1/subscriptions/{subscriptionNumber}/versions/{version}/customFields
Update subscription custom fields of a subscription version
PUT_UpdateSubscriptionCustomFieldsOfASpecifiedVersion 9 params → 200

Schemas 56

The contract defines 56 schemas that model the data the API accepts and returns. The most detailed are PUTSubscriptionSuspendType (24 properties), PUTSubscriptionResumeType (19 properties), PUTSubscriptionResponseType (17 properties), POSTSubscriptionCancellationType (16 properties). Each schema is shown below with its type and property counts.

PUTSrpAddType
PUTSrpChangeType
SubscriptionOfferObjectCustomFields
object
Container for custom fields of a Subscription Offer object.
POSTSubscriptionPreviewResponseType
object
13 properties
PUTSubscriptionResumeType
object
19 properties 1 required
GETIntervalPriceType
object
5 properties
POSTScCreateType
GETIntervalPriceTierType
object
6 properties
AccountObjectCustomFields
object
Container for custom fields of an Account object.
SubscriptionObjectQTFields
object
Container for Subscription fields provided by Zuora Quotes.
6 properties
AccountObjectNSFields
object
Container for Account fields provided by the [Zuora Connector for NetSuite](https://www.zuora.com/connect/app/?appId=265).
9 properties
CommonResponseType
object
3 properties
PUTSubscriptionPreviewInvoiceItemsType
object
10 properties
GETSubscriptionRatePlanChargesType
ChargeModelConfigurationType
object
Container for charge model configuration data. Note: This field is only available if you have the High Water Mark, Pre-Rated Pricing, or Multi-Attribute Pricin…
3 properties
GETDeliveryScheduleType
object
The deliverySchedule is used for the Delivery Pricing charge model only. Note: The Delivery Pricing charge model is in the Early Adopter phase. We are actively…
8 properties
PUTScUpdateType
GETSubscriptionOfferType
SubscriptionObjectNSFields
object
Container for Subscription fields provided by the [Zuora Connector for NetSuite](https://www.zuora.com/connect/app/?appId=265).
5 properties
GETAccountSummaryTypeSoldToContact
Container for sold-to contact information. Note: - If you have the Flexible Billing Attributes feature disabled, this field is unavailable in the request body…
GETSubscriptionRatePlanType
GETSubscriptionTypeWithSuccess
ContactObjectCustomFields
object
Container for custom fields of a Contact object.
POSTSubscriptionPreviewTypePreviewAccountInfo
A container for providing a customer account information if you do not have an existing customer account. This customer account information is only used for su…
GETSubscriptionStatusHistoryType
GETSubscriptionProductFeatureType
object
4 properties
PUTSrpRemoveType
object
9 properties 1 required
PUTScAddType
POSTSubscriptionResponseType
object
9 properties
GETTierType
object
5 properties
POSTSubscriptionPreviewCreditMemoItemsType
object
12 properties
PUTSrpUpdateType
GETSubscriptionWrapper
object
3 properties
POSTSubscriptionPreviewType
POSTSubscriptionPreviewInvoiceItemsType
object
11 properties
POSTTierType
object
5 properties 2 required
PUTSubscriptionResumeResponseType
object
9 properties
PUTSubscriptionSuspendType
object
24 properties 1 required
PUTSubscriptionSuspendResponseType
object
10 properties
PUTSubscriptionPatchSpecificVersionRequestType
object
2 properties
POSTSubscriptionType
SubscriptionObjectCustomFields
object
Container for custom fields of a Subscription object.
PUTRenewSubscriptionResponseType
object
9 properties
PUTDeleteSubscriptionResponseType
object
1 property
GETDiscountApplyDetailsType
object
5 properties
GETAccountSummaryTypeBillToContact
Container for bill-to contact information. Note: - If you have the Flexible Billing Attributes feature disabled, this field is unavailable in the request body…
PUTSubscriptionResponseType
object
17 properties
PUTSubscriptionType
GETSubscriptionType
POSTSubscriptionCancellationResponseType
object
9 properties
RatePlanChargeObjectCustomFields
object
Container for custom fields of a Rate Plan Charge object.
PUTRenewSubscriptionType
object
12 properties
RatePlanObjectCustomFields
object
Container for custom fields of a Rate Plan object.
POSTSubscriptionPreviewTaxationItemsType
object
11 properties
POSTSrpCreateType
POSTSubscriptionCancellationType
object
16 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zuora-subscriptions-api-openapi.yml Raw ↑

Other APIs Zuora publishes across the network.

Zuora V1 API
Zuora Accounting Codes API
Zuora Accounting Periods API
Zuora Accounts API
Zuora Actions API
Zuora Aggregate Queries API
Zuora API Health API
Zuora Attachments API
Zuora Bill Run API
Zuora Bill Run Health API
Zuora Billing Documents API
Zuora Billing Preview Run API