# Your Mapit data, in your own tools

Read your account, your vehicles, where they last reported and the routes you rode: the same things the Mapit app shows, from a script, Home Assistant or an app you build. Without sharing your Mapit password.

> **Beta, free for now.** The Mapit API is a beta: it may change or stop, it comes with no uptime promise, and Mapit does not charge for it today. Do not rely on it for emergencies or to recover a stolen bike: use the Mapit app. [Read the beta terms](https://developers.mapit.me/terms.md).

- [Personal keys](https://developers.mapit.me/keys.md): For your own scripts. Create a key, paste it, done.
- [OAuth](https://developers.mapit.me/oauth.md): For apps that connect other Mapit customers, with their consent.
- [Home Assistant](https://developers.mapit.me/home-assistant.md): Your bike as a device tracker and sensors.
- [Use with AI](https://developers.mapit.me/ai.md): Connect an assistant to your account, or point a coding agent at these docs.
- [API reference](https://developers.mapit.me/reference.md): Every endpoint, parameter and field.

## Try it

With a [personal key](https://developers.mapit.me/keys.md) that can see locations:

```
curl -H "Authorization: Bearer $MAPIT_KEY" https://api.mapit.me/v1/status
```

The answer has one entry per vehicle, with its last reported position, battery and when it last reported.

## What to know first

- **Read-only.** The API cannot change your account, vehicles or settings. The one exception: a personal key with the “Manage connections” option can disconnect your apps and keys.
- **Your data only.** A key or connection sees one customer's vehicles, as the Mapit app shows them.
- **Location and routes are opt-in.** They need their own permission, given when the key or connection is created.
- **Last reported, not live.** Positions are what the tracker last sent; every answer says when.
- **30 requests a minute** per key or access token. Polling `/v1/status` once a minute is plenty. See [Limits](https://developers.mapit.me/limits.md).
- **Stable, as far as a beta can be.** We aim for version 1 to only gain fields. Anything that would break your code gets `/v2`. See [Versions](https://developers.mapit.me/versions.md).

## AI assistants

Claude, ChatGPT and other assistants that support MCP connect through `https://api.mapit.me/mcp`: add it as a connector and sign in with your Mapit account. [Use with AI](https://developers.mapit.me/ai.md) has the steps, and what a coding agent needs to read these docs.
