Versioning Protocols

Calendar Versioning (CalVer)

Calendar Versioning (CalVer) uses the release date as the version identifier, typically in YYYY.MM.DD or YYYY-MM-DD format. Used by APIs like Stripe (date-based versions e.g., 2024-06-01) to communicate when an API version was released rather than the impact of changes.

GitHub

Documentation

📖
Documentation
https://calver.org/

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/versioning-protocols/refs/heads/main/json-schema/versioning-protocols-calver-schema.json

API entry from apis.yml

apis.yml Raw ↑ 
aid: versioning-protocols:calver
name: Calendar Versioning (CalVer)
description: Calendar Versioning (CalVer) uses the release date as the version identifier, typically in
  YYYY.MM.DD or YYYY-MM-DD format. Used by APIs like Stripe (date-based versions e.g., 2024-06-01) to
  communicate when an API version was released rather than the impact of changes.
humanURL: https://calver.org/
tags:
- Calendar Versioning
- CalVer
- Date-Based Versioning
- API Versioning
properties:
- type: Documentation
  url: https://calver.org/
- type: JSONSchema
  url: https://raw.githubusercontent.com/api-evangelist/versioning-protocols/refs/heads/main/json-schema/versioning-protocols-calver-schema.json