---
title: "Get specific alert"
method: GET
path: "/alerts/{id}"
tags: ["alerts"]
---

# Get specific alert

`GET /alerts/{id}`

## Request

- Base URL: `https://aeroapi.flightaware.com/aeroapi`
- URL: `https://aeroapi.flightaware.com/aeroapi/alerts/{id}`
- Auth: API key in header `x-apikey`
- TypeScript: <https://skmtc.dev/flightaware/apis/aeroapi/docs/alerts/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the configuration data for an alert with the specified ID.

## Response `200`

Returns alert configuration structure.

- object
  - `id` integer, required: Unique ID for alert, can be used to update or delete alert.
  - `description` string, required: Server-generated textual description of alert. May include carrier, flight number, origin, destination, etc.
  - `ident` string, nullable, required: Ident to alert on. This value may be modified based on codeshare resolution. If that occurs, the originally provided ident will be preserved in the user_ident field.
  - `ident_icao` string, nullable: ICAO ident to alert on
  - `ident_iata` string, nullable: IATA ident to alert on
  - `origin` string, nullable, required: Origin airport ICAO, IATA, or LID code to alert on.
  - `origin_icao` string, nullable: Origin airport ICAO code to alert on.
  - `origin_iata` string, nullable: Origin airport IATA code to alert on.
  - `origin_lid` string, nullable: Origin airport LID code to alert on.
  - `destination` string, nullable, required: Destination airport ICAO, IATA, or LID code to alert on.
  - `destination_icao` string, nullable: Destination airport ICAO code to alert on.
  - `destination_iata` string, nullable: Destination airport IATA code to alert on.
  - `destination_lid` string, nullable: Destination airport LID code to alert on.
  - `aircraft_type` string, nullable, required: Aircraft type ICAO code to alert on.
  - `created` string, date-time, required: Time that the alert was created.
  - `changed` string, date-time, required: Time that the alert was last modified.
  - `start` string, date, nullable, required: Start date of alert. Should be in departure airport's timezone.
  - `end` string, date, nullable, required: End date of alert (inclusive). Should be in departure airport's timezone.
  - `user_ident` string, nullable, required: Originally specified ident.
  - `eta` integer, required: How many minutes before a flight's ETA that an alert should be delivered. Alerts will only be delivered after the flight has been in the air for at least 15 minutes. Set to 0 to disable.
  - `events` object, required
    - `arrival` boolean, required: Whether alerts should be delivered on arrival. FlightAware Global customers will also receive \"taxi stop\" Ready To Taxi™ alerts unless they've opted out.
    - `cancelled` boolean, required: Whether alerts should be delivered on cancellation by the airline
    - `departure` boolean, required: Whether alerts should be delivered on departure. FlightAware Global customers will also receive \"power on\" and \"taxi start\" Ready To Taxi™ alerts unless they've opted out.
    - `diverted` boolean, required: Whether alerts should be delivered on diversion
    - `filed` boolean, required: Whether alerts should be delivered on filing
    - `out` boolean, required: Whether alerts should be delivered when aircraft leaves departure gate
    - `off` boolean, required: Whether alerts should be delivered when aircraft leaves the runway
    - `on` boolean, required: Whether alerts should be delivered when aircraft touches down on runway
    - `in` boolean, required: Whether alerts should be delivered when aircraft enters arrival gate
  - `target_url` string, nullable, required: Alert specific URL to deliver to. If null, then the alert will be delivered to the configured account-wide alert URL target.
  - `enabled` boolean, required: Whether alert is enabled.

## Other responses

- `404`: No such alert exists.

---

[API](https://skmtc.dev/flightaware/apis/aeroapi.md) - [All operations](https://skmtc.dev/flightaware/apis/aeroapi/llms.txt) - [OpenAPI document](https://skmtc.dev/flightaware/apis/aeroapi/revisions/3023e7a0c54c?raw)