# ISMS Directory API deprecation and sunset policy

Stable REST lives at `/api/v1/`. Unversioned `/api/search` and `/api/market` are compatibility aliases of the same handlers.

## Policy

- Backward-compatible fields may be added inside v1 without a new major version.
- A breaking change requires `/api/v2/` (or a later major path).
- Before removing a stable version we publish a migration note on `/developers` and this file.
- Removal is signaled with RFC 9745 `Deprecation` and `Sunset` response headers, with at least 90 days between those headers and the removal date.
- No sunset is scheduled today. `Deprecation` and `Sunset` headers are not present on current 200 responses because nothing is deprecated.

## How to follow this

- New integrations: `GET https://ismsdirectory.com/api/v1/search`
- Existing `/api/search` clients: no action. The alias stays until a dated Sunset is published here.

Developer portal: https://ismsdirectory.com/developers
OpenAPI: https://ismsdirectory.com/openapi.json