- More OpenAPI specification options
API Reference (2026-10-16)
Welcome to the v1 API reference for the Zuora Billing, Payments, and Platform!
If you are new to the Zuora API, start with our Get started guide to make your first call. To learn about the common use cases of the Zuora v1 API, check out the API Tutorials.
Important: This API Reference only showcases the parameters, fields, and behaviors available for the latest API minor version (2025-08-12). For more information about Zuora API versions, see API versions and API upgrades.
We recommend that you upgrade to the latest API version to take advantage of the latest Zuora capabilities. For instructions about upgrading the API version, see API upgrade guide.
Try the v1 API in our Postman collection:
Some of our older APIs are no longer recommended but still available, not affecting any existing integration. To find related API documentation, see Older API Reference.
The 4-byte UTF-8 characters are not supported for text fields, such as the account names or bill-to contacts' first and last names.
To support your integration with our OpenAPI specifications, whether using in-house solutions or third-party tools, we provide the following resources:
- Order-to-Cash operations (detailed): Download Order-to-Cash OpenAPI spec, which includes full descriptions and examples
- Order-to-Cash operations (compact): Download Order-to-Cash Compact OpenAPI spec, which excludes descriptions and code examples.
- Full OpenAPI spec (compact): Download Compact OpenAPI Spec, which covers the entire API set without descriptions or samples.
If you need a different API specification beyond the options above, contact Zuora Global Support, and we will provide a custom spec tailored to your needs.