Skip to main content
The tipee API is versioned. Each time a breaking change is introduced, a new version is released. The API version name is based on the date when it was released. For example, the API version 25.09.01 was released on Mon, 01 Sep 2025. You can select a version from the header of this documentation to view the reference for that specific version.

​
Selecting an API version

When issuing calls to the API, you must provide the version using the Tipee-Version header:
This header ensures that the API processes your request and formats its response according to that version’s behavior.

​
Breaking vs. non-breaking changes

Additive changes are available in all supported API versions and should not break an integration:

​
Preview endpoints

New endpoints are first released in the preview version, available in the version dropdown of this documentation alongside the stable versions. In that version, each endpoint carries a badge: preview for endpoints that are not part of a stable version yet, and stable for endpoints already released in a stable version (which remain visible there, as they keep working in every later version). To call preview endpoints, use the preview version in the Tipee-Version header:
Preview endpoints should only be used for testing purposes. They are transitioning toward the next stable release — their behavior may change without prior notice. Using them in production is discouraged, especially if you are not able to adapt your integration quickly when a breaking change occurs.

​
Deprecation and backward compatibility

When a new REST API version is released, the previous API version will be supported for at least 6 more months following the release of the new API version.