# Versioning policy

The current version is `v1` (`/api/v1/…`). Within v1 only **additive** changes are made:

- New endpoints, new optional parameters, new response fields, new categories or enum values may appear.
- Existing fields are not removed, renamed or retyped; `hata` and `detay` stay.
- A breaking change only ships under a new version prefix (`/api/v2/`); v1 keeps running alongside for a while.
- An endpoint due for removal is first announced in the [changelog](/en/gelistirici/degisiklik-gunlugu/) and marked `deprecated` in OpenAPI.

## For your client

- Ignore unknown fields; treat an unknown enum value like "other".
- Keep the difference between `null` and `[]` ([empty-list rule](/en/gelistirici/veri-durumu/)).
- Machine-readable definition: [openapi.json](/en/gelistirici/openapi.json).