Original Message:
Sent: 12-15-2025 10:53
From: Isla Taylor
Subject: Partner Billing Usage API is now ready to consume
Hello Martin,
Yes, we have an update involving the following end-points, that are planned to be deprecated sometime between May – July 2026:
· https://billable-vendor-usage-api.usw2.pure.cloud/v1/regions/{region}/organizations?appIds={appIds}
· https://billable-vendor-usage-api.usw2.pure.cloud/v1/regions/{region}/organizations/{orgId}?appIds={appIds}
· https://billable-vendor-usage-api.usw2.pure.cloud/v1/regions?appIds={appIds}
A replacement API (Contract & Billing API), with 6 new end-points is available here:
https://developer.genesys.cloud/platform/preview-apis#billing
With the introduction of the new API, AppFoundry vendors will now be required to use their own Org ID to retrieve customer contract and subscription information. After logging in with your Org ID, your customer orgs will be accessible. We developed internal logic to get customer orgs using the vendor applications, allowing us to provide one unified response. This represents a shift from the current AppFoundry Premium Applications APIs model, where vendors access subscription and usage details using customer Org IDs and App IDs.
You should receive an email from Genesys this month with further instructions
Best regards
Isla Taylor
------------------------------
Isla Taylor
IT Director - Customer & Partner Digital Experience
Original Message:
Sent: 12-15-2025 05:44
From: Martin Gottfried
Subject: Partner Billing Usage API is now ready to consume
Hi Isla,
is there anything new regarding the "Premium Applications - Usage API" replacement?
Thank you for getting back to me!
Martin
------------------------------
Martin Gottfried
2Ring
Original Message:
Sent: 08-25-2025 14:45
From: Isla Taylor
Subject: Partner Billing Usage API is now ready to consume
Hi Erin,
For now, please be assured that we will provide a replacement for the "Premium Applications - Usage API" within the same timeline. It's TBD on whether we will re-use the Partner Billing Usage API or if we will create a new one. We're currently in an architecture review on the final solution.
Hope that is helpful for now.
Best
Isla
------------------------------
Isla Taylor
IT Director - Customer & Partner Digital Experience
Original Message:
Sent: 08-25-2025 14:09
From: Erin Wilson
Subject: Partner Billing Usage API is now ready to consume
Hello - Are these APIs intended to be a replacement for the "Premium Applications – Usage API – Individual Customer Subscription GET endpoint: billable-vendor-usage-api.usw2.pure.cloud/v1/regions/{region}/organizations/{orgId}?appIds={appIds}" as well?
@Isla Taylor
Thanks
------------------------------
Erin Wilson
None
Original Message:
Sent: 08-05-2025 07:11
From: Developer Community
Subject: Partner Billing Usage API is now ready to consume
Summary
Genesys Cloud is transitioning to a new billing system, and as a result, the Partner Billing Usage API will be replaced. We are taking this opportunity to future-proof the API for a better customer experience.
You are impacted if this use case applies to you:
- You are a Genesys Cloud partner using the Partner Billing Usage API to monitor customer usage and generate invoices based on the API data.
- Partner Billing Usage API: /api/v2/billing/trusteebillingoverview/{trustorOrgId}
The API is now available to begin your development work. Please note, only mock data will be available at this time. Genesys plans to deprecate the Partner Billing Usage API at a later date after satisfactory testing and deployment of the new billing system. https://developer.genesys.cloud/platform/preview-apis#billing
We will stay in touch with you throughout the next few months, explaining new milestones and calls to action as necessary for you to complete your testing.
Your CSM is attending internal calls and is your point person for any help needed. Please raise your questions through them.
Effective Date
As notified by Genesys; on or around February 2026
Details
The Partner Billing Usage API is intended for Genesys Partner companies to create systems for customer billing of Genesys Cloud users, devices and resources, and AppFoundry applications. The replacement of the Billing System requires us to replace the API.
The new API has a much richer data set for consumers to see their contracts, subscriptions, rate plans, invoices, quantity commits, balances, drawdown units and overages by billing period all in the same API.
Customer Impact
Customers and Partners consuming the Partner Billing Usage API will need to cut-over to the new API endpoints. Timelines will be communicated along the way to keep all partners informed of the change.
Impacted Resources
Partner Billing Usage API:
Issue References
[PURE-6749]
Contacts
@Isla Taylor
Please reply to this announcement with any questions. This helps the wider developer community benefit from the discussion. We encourage you to use this thread before contacting the designated person directly. Thank you for your understanding.