Loading article…
Loading article…
Last updated on Aug 29, 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.
Renewal Factors themselves are created and managed in Maxio Core, then synced to your Advanced Billing site. See Applying Renewal Factors for how to create and maintain them.
This endpoint is only available on sites with Renewal Factors enabled.
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. |
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.