# Calendar Versioning (CalVer)

**Canonical:** https://apis.io/apis/versioning-protocols/calver/  
**Provider:** Versioning Protocols — https://apis.io/providers/versioning-protocols/  
**Documentation:** https://calver.org/

Calendar Versioning (CalVer) is one of 5 APIs that [Versioning Protocols](https://apis.io/providers/versioning-protocols/) publishes on the [APIs.io](https://apis.io/) network. This API exposes 1 JSON Schema definition. Tagged areas include Calendar Versioning, CalVer, Date-Based Versioning, and API Versioning. The published artifact set on APIs.io includes API documentation and 1 JSON Schema.

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.

## Machine-readable artifacts (2)

- **Documentation** — https://calver.org/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/versioning-protocols/refs/heads/main/json-schema/versioning-protocols-calver-schema.json

## Other Versioning Protocols APIs (4)

- [Semantic Versioning (SemVer)](https://apis.io/apis/versioning-protocols/semver/)
- [URI Path Versioning](https://apis.io/apis/versioning-protocols/uri-path-versioning/)
- [Header-Based Versioning](https://apis.io/apis/versioning-protocols/header-versioning/)
- [OpenAPI Versioning](https://apis.io/apis/versioning-protocols/openapi-versioning/)

## Tags

Calendar Versioning, CalVer, Date-Based Versioning, API Versioning

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/versioning-protocols/calver/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/versioning-protocols/.
