> ## 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=.

# METAR API

> WebSocket push and HTTP for METAR and SPECI on 51 stations.

Connect to `/v1/ws/metar` with the airports you want, send a JSON `ping` every 20 seconds, and read `new_metar_arrived` messages. No reports are sent on connect.

```http Connect theme={"dark"}
wss://mobs.ws/v1/ws/metar?airports=KNYC,KLGA
Authorization: Bearer YOUR_API_KEY
```

`GET /v1/metar/latest` is optional backfill of the current latest report per airport.

API keys are issued on request from [support@mobs.ws](mailto:support@mobs.ws). There are no accounts, plans or sign-up.

> [card] [Quickstart](https://docs.mobs.ws/quickstart.md)
>
> Get an API key, connect, read a record.

> [card] [Authentication](https://docs.mobs.ws/authentication.md)
>
> Send your API key as a Bearer header, or as `?token=` on the socket.

> [card] [WebSocket API](https://docs.mobs.ws/websocket.md)
>
> Connect, change the airport list, new reports, heartbeat, close codes.

> [card] [HTTP API](https://docs.mobs.ws/rest.md)
>
> Latest report per airport, resync after a reconnect, latency.

> [card] [Errors](https://docs.mobs.ws/errors.md)
>
> Socket close codes and HTTP status codes.

> [card] [Stations](https://docs.mobs.ws/stations.md)
>
> The 14 covered stations and their routine minutes.

## Caveat labels

These docs keep two labels from the MOBS docs:

> [!NOTE]
>
> **Placeholder**: behaviour MOBS chose where no public reference exists; may change. Each one has a code such as A6.

> [!WARNING]
>
> **To be confirmed**: waiting on an open decision. Each one has a code such as D3.


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