Search events

GET

api

events

curl -H "Authorization: Bearer $ER_API_KEY" \
  "https://api.enhancedradar.com/api/v0/events?since=2026-10-22T12:00:00Z&until=2026-10-23T12:00:00Z&q=returning+to+the+gate"

{
  "events": [
    {
      "event_id": 5176678,
      "atc_channel_id": 997,
      "facility_ids": ["36bb4190-36e1-4aaf-b677-d9861a66cebb"],
      "happened_at": "2026-10-23T00:14:32.653120731Z",
      "summary": "Gate return, operations coordination, \"we're gonna have to head back to the gate\"",
      "callsigns": ["DAL1042"],
      "evidence_audio_sample_ids": ["9c9cfd6b-5de0-4a68-8ae1-5da0bb5a772a", "…"],
      "updates": [
        {
          "event_update_id": 5176727,
          "update_to_event_id": 5176678,
          "happened_at": "2026-10-23T00:14:32.653120731Z",
          "summary": "Gate return, operations coordination, \"we're gonna have to head back to the gate\"",
          "callsigns": ["DAL1042"],
          "evidence_audio_sample_ids": ["0b4d1e1a-8240-43b4-8710-0429be5c48f6", "…"]
        },
        {
          "event_update_id": 5176921,
          "update_to_event_id": 5176727,
          "happened_at": "2026-10-23T00:14:32.653120731Z",
          "summary": "Gate return, operations coordination, \"they're gonna send us back to gate 10\"",
          "callsigns": ["DAL1042"],
          "evidence_audio_sample_ids": ["0b4d1e1a-8240-43b4-8710-0429be5c48f6", "…"]
        }
      ],
      "similarity_score": 0.71
    }
  ]
}

Searches events: notable things that happened on frequency, such as a go-around, a laser strike, a diversion, or a gate return, each summarized and linked to the transmissions it was found in. Describe what you are looking for in plain words; results are ranked by how closely they match its meaning, not by exact words. An event is reported once and then updated as more transmissions about it arrive. Each event is returned as it was first reported, with all its updates nested under it in updates. Every update has its own event_update_id.

Query parameters

Takes since, until, callsign, facility_id, atc_channel_ids, and airline_id as described in Selecting data. The window selects by happened_at, not received_at: an event matches when its happened_at as first reported, or the happened_at of any of its updates, is in it. See Time windows by endpoint.

string

required

What you are looking for, e.g. laser strike on approach or aircraft returning to the gate.

string

required

Start of the window, inclusive. RFC 3339.

string

required

End of the window, inclusive. Must be after since and at most 48 hours later.

string

ICAO callsign, e.g. UAL406. Case-insensitive.

string

A facility_id from GET /api/v0/facilities.

string

Comma-separated atc_channel_id values, e.g. 4,7,8. Every channel must be available.

integer

An airline_id from GET /api/v0/airlines.

integer

default:"10"

Maximum events to return, 1 to 25.

Results are the best matches in one page; there is no cursor. With facility_id or atc_channel_ids, a page can hold fewer than limit events.

Response

array

The events, best match first.

Show event

integer

Id of the event as first reported.

integer

The channel the event happened on.

string[]

Facilities that channel belongs to.

string

When the event happened, as first reported, in UTC, accurate to within 20 seconds. See Times.

string

One-line summary as first reported, usually with a quote from the frequency.

string[]

ICAO callsigns of the flights involved, as first reported.

string[]

Transmissions the event was first found in. Fetch them with Get transcript and Get transcript audio.

array

Every later update of the event, oldest first; empty if it was never updated. The last one is the most complete.

Show update

integer

Id of this update.

integer

What this update revised: the event_id, or the event_update_id of an earlier update. An event can branch when two updates revise the same one.

string

When the event happened, as of this update.

string

One-line summary as of this update.

string[]

ICAO callsigns of the flights involved, as of this update.

string[]

Transmissions the event was found in, as of this update.

number

How closely the event matches q: the cosine similarity between q and the event’s description, at most 1; higher is better. Scores are comparable across requests for the same q. It is the same score the live events topic compares with minimum_similarity_score.

Billing

Each search is charged as one event_query_page, at $1.00, even when nothing matches. Each event returned is charged as one event_pull, at $1.00. An event’s updates are included in its event_pull. See Pricing and Billing.

Errors

Status	Meaning
`400`	`q`, `since`, or `until` is missing, or a parameter is invalid.

curl -H "Authorization: Bearer $ER_API_KEY" \
  "https://api.enhancedradar.com/api/v0/events?since=2026-10-22T12:00:00Z&until=2026-10-23T12:00:00Z&q=returning+to+the+gate"

{
  "events": [
    {
      "event_id": 5176678,
      "atc_channel_id": 997,
      "facility_ids": ["36bb4190-36e1-4aaf-b677-d9861a66cebb"],
      "happened_at": "2026-10-23T00:14:32.653120731Z",
      "summary": "Gate return, operations coordination, \"we're gonna have to head back to the gate\"",
      "callsigns": ["DAL1042"],
      "evidence_audio_sample_ids": ["9c9cfd6b-5de0-4a68-8ae1-5da0bb5a772a", "…"],
      "updates": [
        {
          "event_update_id": 5176727,
          "update_to_event_id": 5176678,
          "happened_at": "2026-10-23T00:14:32.653120731Z",
          "summary": "Gate return, operations coordination, \"we're gonna have to head back to the gate\"",
          "callsigns": ["DAL1042"],
          "evidence_audio_sample_ids": ["0b4d1e1a-8240-43b4-8710-0429be5c48f6", "…"]
        },
        {
          "event_update_id": 5176921,
          "update_to_event_id": 5176727,
          "happened_at": "2026-10-23T00:14:32.653120731Z",
          "summary": "Gate return, operations coordination, \"they're gonna send us back to gate 10\"",
          "callsigns": ["DAL1042"],
          "evidence_audio_sample_ids": ["0b4d1e1a-8240-43b4-8710-0429be5c48f6", "…"]
        }
      ],
      "similarity_score": 0.71
    }
  ]
}

⌘I

curl -H "Authorization: Bearer $ER_API_KEY" \
  "https://api.enhancedradar.com/api/v0/events?since=2026-10-22T12:00:00Z&until=2026-10-23T12:00:00Z&q=returning+to+the+gate"

{
  "events": [
    {
      "event_id": 5176678,
      "atc_channel_id": 997,
      "facility_ids": ["36bb4190-36e1-4aaf-b677-d9861a66cebb"],
      "happened_at": "2026-10-23T00:14:32.653120731Z",
      "summary": "Gate return, operations coordination, \"we're gonna have to head back to the gate\"",
      "callsigns": ["DAL1042"],
      "evidence_audio_sample_ids": ["9c9cfd6b-5de0-4a68-8ae1-5da0bb5a772a", "…"],
      "updates": [
        {
          "event_update_id": 5176727,
          "update_to_event_id": 5176678,
          "happened_at": "2026-10-23T00:14:32.653120731Z",
          "summary": "Gate return, operations coordination, \"we're gonna have to head back to the gate\"",
          "callsigns": ["DAL1042"],
          "evidence_audio_sample_ids": ["0b4d1e1a-8240-43b4-8710-0429be5c48f6", "…"]
        },
        {
          "event_update_id": 5176921,
          "update_to_event_id": 5176727,
          "happened_at": "2026-10-23T00:14:32.653120731Z",
          "summary": "Gate return, operations coordination, \"they're gonna send us back to gate 10\"",
          "callsigns": ["DAL1042"],
          "evidence_audio_sample_ids": ["0b4d1e1a-8240-43b4-8710-0429be5c48f6", "…"]
        }
      ],
      "similarity_score": 0.71
    }
  ]
}

Overview

Coverage

Transcripts

Events

Status

PIREPs

Answers

Live WebSocket

Utility

Query parameters

Response

Billing

Errors

​Query parameters

​Response

​Billing

​Errors

Query parameters

Response

Billing

Errors