The Nuvion API is versioned by date. Breaking changes are introduced in new versions — older versions continue to work until they are deprecated.
Setting the version
Pass the version as a request header:
If you omit the header, your requests are routed to the latest version (2026-02-06). To pin your integration to a specific version, always send the header explicitly.
Pin to a specific version in production. Relying on the default means your integration will automatically receive future breaking changes.
Versions
2026-02-06 — Current
The latest version. This is the default when no X-API-Version header is sent.
2026-01-01 — Previous
The previous stable version. Still supported — pass the header to continue receiving the old response structure.
A deprecation and sunset date for 2026-01-01 will be communicated with a minimum of 90 days notice via email and in these docs.
Migrating from 2026-01-01 to 2026-02-06
To migrate, update your integration to handle the new response structure, then switch the header (or remove it to use the default).
If you need help identifying what changed for a specific endpoint, contact support.
Version errors
