Access Renewal Factors via the API
Last updated on Sep 19, 2026
Advanced Billing exposes your site's Renewal Factor values through a read-only public API endpoint, so external systems and integrations can retrieve them without a user manually checking the Renewal Factor drop-down in a Transaction. The Renewal Factors themselves are created and managed in Maxio Core, then synced to your Advanced Billing site.
This endpoint is only available on sites with Auto Renewals enabled.
List renewal factors
GET /api/v3/renewal_factorsReturns every Renewal Factor defined for your site. This is a list-only endpoint; there's no way to retrieve a single Renewal Factor by ID.
Each Renewal Factor includes the following fields:
| Field | Description |
|---|---|
id | The Renewal Factor's ID within Advanced Billing. |
maxio_id | The Renewal Factor's ID in Maxio Core. |
name | The Renewal Factor's name, as set in Maxio Core. |
factor | The multiplier applied to a Transaction's Amount when it renews using this Renewal Factor. |
created_at | The timestamp the Renewal Factor was created. |
updated_at | The timestamp the Renewal Factor was last updated. |
Related information
For how to create and maintain Renewal Factors in Maxio Core, see the Applying Renewal Factors help article.
For complete request and response details, including authentication, consult the OpenAPI documentation available in your Maxio instance.
Still need help?
Reach out and our support team will take it from here.