# Versions and deprecation

The version and deprecation policy behind the [API terms of use](https://developers.mapit.me/terms.md). The current version is `https://api.mapit.me/v1` (v1).

> **Beta.** While the API is a beta, this policy is a goal, not a guarantee: Mapit may make a breaking change sooner, and will tell you on this site where it can.

## Policy

- **v1 only gains fields.** Mapit does not remove or rename a field, or change what it means, within a version. Your code should ignore fields it does not know.
- **Breaking changes get a new version**, such as `/v2`.
- **Six months' notice** on this site before a version is retired.
- Features labelled **Beta** may change or end without a new version.
