**08** Guides

# API versions and changelog

## Compatibility

Within /v1 fields are never removed or renamed; new optional fields may appear — do not fail on unknown keys. Breaking changes will ship under /v2 with a transition period announced in the bot.

## Changelog

### October 2026: model generation and family

- The generation field (Korea) and the [catalog's generation filter](https://apiauto.space/en/docs/endpoints/cars/) ; model is the model family, one name in every market.

### September 2026: API v1 released

- [Catalog](https://apiauto.space/en/docs/endpoints/cars/) , [car by id](https://apiauto.space/en/docs/endpoints/car/) , [change feed](https://apiauto.space/en/docs/endpoints/changes/) , [references](https://apiauto.space/en/docs/endpoints/references/) , [usage](https://apiauto.space/en/docs/endpoints/usage/) , [live US search](https://apiauto.space/en/docs/endpoints/live/) .
- Signed photo links through /img.
- Makes and models are spelled the same in every market (Ford, Mercedes-Benz, CX-5, XC60); the original spellings stay in raw.source_values.
- /v1/references/markets has data_age_seconds and stale: how fresh each market's copy is.

---

Page: https://apiauto.space/en/docs/changelog/