# Billing API Changelog

This is the public change record for the Billing API. Billing follows
Fynex's shared public API lifecycle policy: Payments and Billing both support
a public major version for at least 12 months after its successor is generally
available, and both give at least 90 calendar days' notice before removing a
public contract.

## 2026-09-13

### Deprecated: `origin=subscription` query alias

`origin=subscription` is a deprecated alias for `origin=recurring` on
`GET /billing-api/v1/invoices`. Notice date: 2026-09-13. The legacy alias is
still accepted and returns the same invoice rows as `origin=recurring`, but it
is no longer produced for newly created invoices. Update integrations to use
`origin=recurring`.

The planned removal date is 2026-12-13, providing 91 calendar days' notice,
which is at least 90 calendar days. This is a **query-value deprecation**, not
an HTTP operation retirement. An OpenAPI `deprecated: true` marker applies to
an operation, parameter, field or schema; this individual enum-like query
value cannot be represented by an operation-level marker. The public changelog
entry is therefore the applicable value-level deprecation signal. Do not mark
the whole `origin` query parameter deprecated, and do not expect
`Deprecation` or `Sunset` response headers for this query value.