API versioning
On this page
Purpose
The API is versioned by date. Choose the version with the Billyou-Version header.
Supported versions
| Version | Role |
|---|---|
2026-08-01 | Latest. Uses the explicit VAT model and per-line discount. |
2026-03-01 | Still supported. |
Billyou-Version: 2026-08-01
When the header is omitted
A request without Billyou-Version resolves to 2026-08-01. The version stored on the API key is not used.
Sunset versions
A sunset version is rejected with HTTP 400 and errorCode API_VERSION_SUNSET:
{ "success": false, "errorCode": "API_VERSION_SUNSET", "message": "..." }
Webhooks
Webhook bodies always send api_version 2026-03-01, including when the API call that produced the event used 2026-08-01. See Webhooks.