Date-Based API Versioning

Live

What it is

The first date-based API version, 2026-03, is now available. Date-based versioning APIs from 2026-03 onward use a YYYY-MM format to clearly indicate the year and month they went live.

Why it matters

For included APIs, date-based versioning brings clearer expectations around timing of change with consistent windows for updates and support. Plan with confidence — breaking changes to supported APIs occur twice a year (March and September), with 18 months of support for each version. Reduce maintenance overhead — immutable API versions in 2026-03 mean your supported APIs won't lead your integration to break unexpectedly within an API's support window, and you can migrate to newer versions on your own timeline. Navigate APIs more easily — Before, v1, v2, v3, v4 denoted versions of APIs. With date-based versioning, APIs from 2026-03 onward will use a YYYY-MM format to clearly indicate the year and month they went live.

Produced by Value-First Media