Versioning
The API version and how changes are made.
The current version
The current version is 2026-11-01. You can pin it with the Esora-Version header; without the header you get the current version. An unknown version is refused with 400 version_invalid.
Esora-Version: 2026-11-01We add things without a new version: new endpoints, new optional parameters, new fields in objects and new event types. Write your code to ignore fields it doesn’t know. Anything that would break existing code gets a new dated version, announced in the changelog first.