List ATCSCC Advisories
faa_delays_list_advisoriesList the ATCSCC advisories issued on one UTC date, newest first, from the FAA advisories database's per-date index: ground stops and delay programs as issued, proposed, revised, and canceled, required reroutes, flow constrained areas, operations plans, and CDM compression advisories, including those no longer active and those on past dates, which the NAS Status feed does not carry. Each row gives the advisory number, control element, subject, any further title lines (a reroute's name, constrained area, and valid period), and send time; its number and date open the full text with faa_delays_get_advisory. Narrow by categories or by control_element (an airport, its ICAO code, an ARTCC, or DCC for national advisories), and page with limit and offset.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | UTC date to list, YYYY-MM-DD; MM/DD/YYYY and M/D/YYYY are also accepted. Omit for today (UTC). No later than tomorrow (UTC); past dates remain available. | |
| limit | No | Advisories per page, 1–200. | |
| offset | No | Matching advisories to skip, for paging: nextOffset from the previous page. | |
| categories | No | Only advisories the FAA files under these categories: ground_stop, ground_delay_program, airspace_flow_program, ctop, route, other (flow constrained areas and operations plans file under other). Also accepts gs, gdp, afp, spelled-out names such as "ground stop", and a comma-separated string; case-insensitive. Omit for every advisory, including CDM compression advisories, which the FAA files under no category. | |
| control_element | No | Only advisories whose control element is this facility or lists it as a part: an airport by FAA identifier (ORD) or ICAO code (KORD), an ARTCC (ZAU), a pair (ORD/ZAU or KORD/ZAU), or DCC for national advisories such as reroutes and the operations plan. Case-insensitive. Airports named only in a subject or details do not match. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit applied; present only when more advisories remain. | |
| date | No | The UTC date read, YYYY-MM-DD; today (UTC) when date was omitted. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Advisories on this page; present only when more remain. | |
| notice | No | Guidance on an empty date, a filter that matched nothing, an offset past the end, more pages, and index rows that could not be read. | |
| truncated | No | True when matching advisories remain past this page; absent otherwise. | |
| advisories | No | Advisories issued on date that match categories and control_element, newest first: up to limit of them, starting at offset. | |
| nextOffset | No | offset of the next page; present while matching advisories remain past this one. | |
| totalCount | No | Advisories on date that match categories and control_element, before paging. | |
| appliedCategories | No | The categories filter as the server normalized it; absent when omitted, which reads every advisory, uncategorized ones included. | |
| appliedControlElement | No | The control_element filter as the server matched it: uppercased, each ICAO airport code in it mapped to its FAA identifier (KORD → ORD, KORD/ZAU → ORD/ZAU); absent when omitted. |