---
title: "Get all configured alerts"
method: GET
path: "/alerts"
tags: ["alerts"]
---

# Get all configured alerts

`GET /alerts`

## Request

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

Returns all configured alerts for the FlightAware account (this
includes alerts configured through other means by the FlightAware user
owning the AeroAPI account like FlightAware's website or mobile apps).

## Query parameters

- `max_pages` integer
- `cursor` string

## Response `200`

List of all alerts.

- object
  - `links` object, nullable: Object containing links to related resources.
    - `next` string, uri-reference, required: A link to the next set of records in a collection.
  - `num_pages` integer: Number of pages returned
  - `alerts` object[], required
    - `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.

---

[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)