We periodically release new, dated versions of the API whenever we make breaking changes. Although we try to only make backwards-compatible changes, sometimes we have to make a breaking change to iterate on the API.
We consider the following changes backwards compatible:
- Adding new API endpoints
- Adding new optional parameters to existing endpoints
- Adding new data elements to existing responses
- Adding new response codes
- Adding new enum values
- Changing the length or content of any API identifier
Our current version is v1.
If a change is not backward-compatible, then it is your responsibility to upgrade your code within the deprecation notice period.
Deprecation Notice Period
Changes are announced, and made, on the first week of each month. Between the date of announcement and deprecation, there are 120 days for you to upgrade your code.