> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobs.ws/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The WebSocket at wss://mobs.ws/v1/ws/metar is the product. The HTTP API is a fallback for backfill only.
> Follow /agents.md for connect, auth, fields, heartbeat, reconnect, and dedupe. Never log MOBS_TOKEN or a URL that includes ?token=.

# Authentication

> API access uses an API key, issued on request. There are no accounts, plans or sign-up.

## Get an API key

Email [support@mobs.ws](mailto:support@mobs.ws) to request an API key for your application.

> [!NOTE]
>
> There are no plans, trials or self-serve keys. Placeholder · A15

## Send it

Pass your API key as a Bearer header, `Authorization: Bearer YOUR_API_KEY`, on the socket handshake and on HTTP. The socket also accepts it as `?token=`, because browsers cannot set socket headers.

> [tab] Authorization header
>
> On the WebSocket handshake and on every HTTP request.
>
> ```http Header theme={"dark"}
> Authorization: Bearer YOUR_API_KEY
> ```

> [tab] token query parameter
>
> On the WebSocket only, for browsers, which cannot set socket headers.
>
> ```text URL theme={"dark"}
> wss://mobs.ws/v1/ws/metar?airports=KNYC&token=YOUR_API_KEY
> ```

Keep API keys out of public repositories and shared code.

## API key scopes

Every scope is read-only.

| Scope | Opens |
| - | - |
| `stream` | `/v1/ws/metar` |
| `latest` | `/v1/metar`, `/v1/metar/latest`, `/v1/metar/latency` |

`GET /v1/status` and `GET /v1/stations` are public.

## Rotation and revocation

The operator can issue a replacement with an overlap, then retire the old API key. When an API key is revoked or expires, its open sockets close with `4403`. Treat an API key like a password.

> [card] [Next: Rate limits](https://docs.mobs.ws/rate-limits.md)
>
> Sockets, HTTP requests and airports per API key.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.