BillyouHelp

↑↓ select · ↵ open · Esc close

API versioning

On this page

Purpose

The API is versioned by date. Choose the version with the Billyou-Version header.

Supported versions

VersionRole
2026-08-01Latest. Uses the explicit VAT model and per-line discount.
2026-03-01Still 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.