# FAA NAS Status — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Monitor real-time FAA airspace conditions to check airport delays, closures, ground stops, and active events affecting flights. Track forecasts, reroutes, and flow program changes to stay informed about current and upcoming disruptions across the National Airspace System.

**Category:** Travel | **Website:** [nasstatus.faa.gov/](https://nasstatus.faa.gov/) | **Docs:** [parse.bot/marketplace/1653ca7f-ec7e-4562-9a3f-ac6c43489fc1/nasstatus-faa-gov-api](https://parse.bot/marketplace/1653ca7f-ec7e-4562-9a3f-ac6c43489fc1/nasstatus-faa-gov-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_active_airport_events

Get list of all active airport events with details including ground stops, ground delays, closures, arrival/departure delays, deicing, and free-form NOTAMs. Each event is normalized with airport code, event type, time range, delay, reason, scope, and runway configuration. Returns real-time data; the items array may be empty when no events are active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_active_airport_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_active_en_route_events

Get active en-route events (e.g., miles-in-trail restrictions, airspace flow programs). Returns real-time data; the events array may be empty when no en-route events are active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_active_en_route_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_airport_closures

Get currently active Airport Closures with full event details. Returns real-time data; the items array may be empty when no closures are active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_airport_closures \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_airport_event_details

Get detailed event information for a specific airport, including ground stop/delay, closures, arrival/departure delays, runway config, deicing status, and free-form NOTAMs. Returns stale_input with kind input_not_found if the airport has no active events in the system.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `airport_code` | string | Yes | FAA airport code (e.g., EWR, JFK, SFO, LAX, LAS, SAN) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_airport_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"airport_code":"<string>"}'
```

### get_airport_status_xml

Fetch airport status data from the FAA XML feed, including delay types and airport closure information. Returns a structured representation of the XML feed with update timestamp and delay/closure entries.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_airport_status_xml \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_airspace_flow_programs

Get currently active Airspace Flow Programs (AFP). AFPs are en-route events; returns real-time data. The items array may be empty when no AFPs are active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_airspace_flow_programs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_atcscc_announcements

Get ATCSCC (Air Traffic Control System Command Center) announcements and miscellaneous information. Returns an object with items array of announcement objects with event text.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_atcscc_announcements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_current_reroutes

Get currently active re-route advisories with structured data including advisory details, route name, constrained area, and valid times. Returns real-time data; the reroutes array may be empty when no advisories are active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_current_reroutes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_edct_lookup

Look up Expected Departure Clearance Time (EDCT) for a flight by callsign, departure, and arrival airports. Returns raw text from the FAA EDCT lookup page. When no EDCT is assigned, the text indicates no information is available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `arr` | string | Yes | Arrival airport code (e.g., SFO, ATL, DFW) |
| `callsign` | string | Yes | Flight callsign (e.g., UAL123, DAL456, AAL789) |
| `dept` | string | Yes | Departure airport code (e.g., ORD, JFK, LAX) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_edct_lookup \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arr":"<string>","callsign":"<string>","dept":"<string>"}'
```

### get_forecast_events

Get forecast events (terminal and en-route planned) from the FAA operations plan advisory. Includes a link to the full advisory document, terminal planned events (ground stops/delay programs), and en-route planned events (CDRs, SWAPs, arrival routes).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_forecast_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_ground_delay_programs

Get currently active Ground Delay Programs (GDP) with full event details for each affected airport. Returns real-time data; ground_delay_programs array may be empty when no GDPs are active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_ground_delay_programs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_ground_stops

Get currently active Ground Stops with full event details for each affected airport. Returns real-time data; ground_stops array may be empty when no ground stops are active.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_ground_stops \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_nas_status_summary

Get a high-level summary of the current NAS status with counts of active events by type and a list of affected airport codes. Combines airport events and en-route events into a single overview.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_nas_status_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_status_by_view

Get NAS status data combining airport and en-route events in a single response. The view parameter controls the intended presentation format (list, tile, or map) but data content is the same structured event objects.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `view` | string | No | View format: list, tile, or map. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nasstatus-faa-gov-api-1653ca7f/get_status_by_view \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"view":"<string>"}'
```