# FAA NAS Status — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```