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

# API reference

> Base URL, authentication, and every route in the Enhanced Radar API.

## Base URL

```text theme={null}
https://api.enhancedradar.com
```

All paths are under `/api/v0` except `/health`.

## Authentication

Send an API key as a bearer token. Every route requires the `api:read` permission, except `GET /health`, which is public, and `GET /api/v0/facilities/search` and `GET /api/v0/pricing`, which also accept `api:onboarding`. See [Authentication](https://enhancedradar.com/docs/api/docs/api/authentication.md).

```http theme={null}
Authorization: Bearer sk_...
```

## Routes

| Method | Path | Description |
| - | - | - |
| `GET` | [`/health`](https://enhancedradar.com/docs/api/docs/api/api-reference/health) | Liveness check. Public. |
| `GET` | [`/api/v0/docs`](https://enhancedradar.com/docs/api/docs/api/api-reference/docs) | This reference as Markdown. |
| `GET` | [`/api/v0/pricing`](https://enhancedradar.com/docs/api/docs/api/api-reference/pricing) | What each item costs in US dollars, and the account tiers and their limits. |
| `GET` | [`/api/v0/facilities`](https://enhancedradar.com/docs/api/docs/api/api-reference/facilities/list) | Facilities we cover and their channels. |
| `GET` | [`/api/v0/facilities/search`](https://enhancedradar.com/docs/api/docs/api/api-reference/facilities/search) | Airports, TRACONs, and centers that best match a code or name. |
| `GET` | [`/api/v0/airlines`](https://enhancedradar.com/docs/api/docs/api/api-reference/airlines/list) | Airlines that `airline_id` accepts. |
| `GET` | [`/api/v0/transcripts`](https://enhancedradar.com/docs/api/docs/api/api-reference/transcripts/list) | Transcripts of ATC transmissions, newest first, or a full-text search. |
| `GET` | [`/api/v0/transcripts/{audio_sample_id}`](https://enhancedradar.com/docs/api/docs/api/api-reference/transcripts/get) | One transcript by id. |
| `GET` | [`/api/v0/transcripts/{audio_sample_id}/audio`](https://enhancedradar.com/docs/api/docs/api/api-reference/transcripts/audio) | Short-lived link to one transmission's audio. |
| `GET` | [`/api/v0/events`](https://enhancedradar.com/docs/api/docs/api/api-reference/events/search) | Search for events: notable things that happened on frequency. |
| `GET` | [`/api/v0/events/{event_id}`](https://enhancedradar.com/docs/api/docs/api/api-reference/events/get) | One event with all its updates. |
| `GET` | [`/api/v0/flights/status`](https://enhancedradar.com/docs/api/docs/api/api-reference/flights/status) | The latest status of one flight at a given time. |
| `GET` | [`/api/v0/airports/status`](https://enhancedradar.com/docs/api/docs/api/api-reference/airports/status) | What is going on at one airport right now: runways, flow, traffic programs, and what was heard on frequency. |
| `GET` | [`/api/v0/pireps`](https://enhancedradar.com/docs/api/docs/api/api-reference/pireps/search) | Search pilot weather reports made near a point. |
| `POST` | [`/api/v0/answers`](https://enhancedradar.com/docs/api/docs/api/api-reference/answers/create) | Answer a question from radio transcripts, ADS-B, FAA SWIM records, weather, and the web, with the evidence behind it. |
| `GET` | [`/api/v0/live`](https://enhancedradar.com/docs/api/docs/api/api-reference/live/connect) | WebSocket that streams live transcripts, events, flight statuses, airport statuses, and PIREPs. |

## Conventions

* [Selecting data](https://enhancedradar.com/docs/api/docs/api/concepts/selecting-data.md): `since`, `until`, and filters shared by pull endpoints.
* [Times](https://enhancedradar.com/docs/api/docs/api/concepts/times.md): RFC 3339, UTC, and `received_at` precision.
* [Errors](https://enhancedradar.com/docs/api/docs/api/concepts/errors.md): error format and status codes.
* [Billing](https://enhancedradar.com/docs/api/docs/api/concepts/billing.md): what each route and live topic charges, in US dollars, and the receipt each one reports.
* [Interpreting results](https://enhancedradar.com/docs/api/docs/api/concepts/interpreting-results.md): what empty, `null`, and updated results mean.

> [!WARNING]
>
> Statuses, events, observations, PIREP conditions, and answers are written by a language model from transcripts and can contain mistakes. Check important details against the transcripts and evidence.


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