Get billing intervals
Get the list of supported billing intervals and their display labels. --- **Related endpoints** - `POST /billing/preview` — Generate billing schedule preview - `GET /billing/anchor-rules` — Get billing anchor rules **Pagination** Offset-based with `limit` (default 25, max 100) and `offset`. The response `pagination` block includes `total` and `hasMore`. See [the pagination guide](/docs/fundamentals/pagination) for SDK auto-paging helpers.
Get the list of supported billing intervals and their display labels.
Related endpoints
POST /billing/preview— Generate billing schedule previewGET /billing/anchor-rules— Get billing anchor rules
Pagination
Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.
Your RevKeen merchant API key. Create and manage keys in Dashboard → Settings → Developer. Use rk_sandbox_* for staging/test and rk_live_* for production. The same key may be sent as Authorization: Bearer <key> if that suits your HTTP client better. A missing, invalid, expired, or revoked key returns 401 with a WWW-Authenticate: Bearer challenge; a valid key without the required scope returns 403.
In: header
Response Body
application/json
application/json
application/json
curl "https://api.revkeen.com/v2/billing/intervals" \
-H "x-api-key: $REVKEEN_API_KEY"{ "data": [ { "value": "string", "label": "string", "description": "string" } ]}Get billing anchor rules GET
Get the list of supported billing anchor rules with explanations. --- **Related endpoints** - `POST /billing/preview` — Generate billing schedule preview - `GET /billing/intervals` — Get billing intervals **Pagination** Offset-based with `limit` (default 25, max 100) and `offset`. The response `pagination` block includes `total` and `hasMore`. See [the pagination guide](/docs/fundamentals/pagination) for SDK auto-paging helpers.
Generate billing schedule preview POST
Generate a preview of upcoming billing dates and amounts based on the provided schedule configuration. This endpoint uses the same billing calculation logic as the actual scheduler, ensuring that the preview matches what will actually be billed (Key Invariant #4: Preview === Scheduler). Use this to show customers their expected billing schedule before they subscribe, or to preview changes to an existing subscription's billing configuration. --- **Related endpoints** - `GET /billing/intervals` — Get billing intervals - `GET /billing/anchor-rules` — Get billing anchor rules **Common errors** - `400 invalid_request` — malformed payload or failed validation. **Idempotency** Pass an `Idempotency-Key` header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see [the idempotency guide](/docs/fundamentals/idempotency).