# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/faa-nas-status/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/faa-nas-status/get-active-airport-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-active-en-route-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-airport-closures \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-airport-event-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-airport-status-xml \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-airspace-flow-programs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-atcscc-announcements \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-current-reroutes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-edct-lookup \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-forecast-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-ground-delay-programs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-ground-stops \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-nas-status-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/faa-nas-status/get-status-by-view \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"view":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.