Breaking Changes
Breaking Change: Deprecation of Billing API v1
As part of our ongoing efforts to streamline our services, we are deprecating the legacy Billing API v1. This change allows us to focus on our more powerful and flexible Subscriptions API.
Migration Guide All functionality from the Billing API v1 is now available in the Subscriptions API. Here’s how you would change a call to fetch invoices:
**Legacy Billing API v1:**
javascript
// DEPRECATED
const invoices = await billingApi.getInvoices({ customerId: 'cust_123' });
**New Subscriptions API:**
javascript
// NEW
const invoices = await subscriptionsApi.invoices.list({ customer: 'cust_123' });
Timeline - **July 10, 2024:** Deprecation announcement. - **September 1, 2024:** Billing API v1 endpoints will no longer be available.
We urge all developers to migrate their applications as soon as possible. Please contact support if you have any questions.