API Basics

API versioning

3 min

All API endpoints contain a numbered version in the URL. Whenever breaking changes are made to the API, a new major version will be created.

Curl


Breaking changes

  • Adding new required fields to request
  • Changes to the response format
  • Data type changes
  • Modifying an endpoint URL
  • Removing endpoints

Non-breaking changes

  • Adding new endpoints
  • Adding new optional fields to request
  • Adding new fields to response
  • Adding new values to fields (e.g. a new status value)
  • Bug fixes

Deprecated Versions When we release a new major version, we will continue to support the previous version for a period of at least 6 months before it is deprecated.