# API changelog

This page summarizes how the iClosed public API evolves. For every request and response field, treat the [OpenAPI specification](/openapi/v1/openapi) and the hosted [API reference](https://api-docs-iclosed.redocly.app/openapi/v1/openapi) as the source of truth.

## Versioning policy

- **Current version:** **v1** — all paths are prefixed with `/v1/`.
- **Non-breaking changes** — new optional fields, new endpoints, or additive enum values may ship without a version bump.
- **Breaking changes** — incompatible changes ship as **`/v2/`** with a transition period (at least **60 days** of overlap with v1, as described on the [introduction page](/)).


## Record of notable changes

| Date | Summary |
|  --- | --- |
| — | *No dated entries yet.* Add rows here when you publish user-facing API changes. |


For the latest machine-readable contract, diff or import [`openapi/v1/openapi.json`](/openapi/v1/openapi) from this repository.