Core concepts

Versioning & deprecation

The major version lives in the path: /open/v1. We bump it only for breaking changes. Additive changes — new fields, new endpoints — ship within the same version, which is why your parser must tolerate unknown fields.

When a version is scheduled for retirement it runs for at least 6 more months, and responses carry X-API-Version-Deprecated: true for the whole sunset window. New versions land in Sandbox before Production.