---
title: "Get a national park's live status"
method: GET
path: "/nationalparks/{id}"
tags: ["National parks"]
---

# Get a national park's live status

`GET /nationalparks/{id}`

## Request

- Base URL: `https://status.live/api/v1`
- URL: `https://status.live/api/v1/nationalparks/{id}`
- Auth: none required

US parks (NPS park code, e.g. `yose`): alerts, road events, access road conditions, campgrounds and visitor centers open today, NWS warnings, wildfires within 50 km, air quality, weather, webcams. Canadian parks (e.g. `banff`): bulletins, weather alerts, fire hotspots, air quality, weather, webcams.

## Path parameters

- `id` string, required

## Query parameters

- `wait_ms` integer

## Response `200`

OK

- union: US parks have alerts and campgrounds; Canadian parks have bulletins.
  - UsParkStatus
    - `park` object
      - `id` string
      - `name` string
      - `country` 'United States' | 'Canada'
      - `designation` string
      - `regions` string[]
      - `location` Location, nullable
        - `lat` number, required
        - `lon` number, required
      - `url` string, uri
      - `api_url` string, uri
      - `website` string, uri
    - `alerts` object
      - `as_of` string, date-time, nullable, required: When it was read from the source (UTC)
      - `age_s` integer, nullable, required: Its age in seconds
      - `stale` boolean, required: Older than about three refreshes of its source
      - `state` 'reported' | 'source_error'
      - `items` object[]
        - `category` string
        - `title` string
        - `description` string
        - `url` string, uri, nullable
    - `access_roads` union
      - Roads
        - `as_of` string, date-time, nullable, required: When it was read from the source (UTC)
        - `age_s` integer, nullable, required: Its age in seconds
        - `stale` boolean, required: Older than about three refreshes of its source
        - `state` 'reported' | 'source_error'
        - `source` Source
          - `name` string, required
          - `url` string, uri
          - `license` string
        - `items` object[]
          - `road` string
          - `clear` boolean: No restriction
          - `text` string: The source's own words
          - `code` string: e.g. Caltrans chain control R-2
          - `since` string
      - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
        - `state` 'loading', required
    - `roads` object, nullable
      - `as_of` string, date-time, nullable, required: When it was read from the source (UTC)
      - `age_s` integer, nullable, required: Its age in seconds
      - `stale` boolean, required: Older than about three refreshes of its source
      - `state` string
      - `items` object[]
        - `road` string
        - `closed` boolean
        - `type` string
        - `description` string
        - `start` string, nullable
        - `end` string, nullable
    - `weather_alerts` union
      - object[]
        - `event` string
        - `severity` string
        - `headline` string
        - `ends` string, nullable
      - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
        - `state` 'loading', required
    - `fires` union
      - object[]
        - `name` string
        - `acres` number
        - `contained_pct` number, nullable
        - `km` number
        - `prescribed` boolean
      - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
        - `state` 'loading', required
    - `air` union
      - object
        - `us_aqi` integer
        - `pm25` number
        - `category` string
      - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
        - `state` 'loading', required
    - `date` string, date
    - `campgrounds` object[]
      - `name` string
      - `open_today` boolean
      - `changes_on` string, date, nullable
      - `alert` boolean: Named in a current alert
      - `sites` integer
      - `reservable` boolean
      - `location` Location, nullable
        - `lat` number, required
        - `lon` number, required
      - `url` string, uri, nullable
      - `reservation_url` string, uri, nullable
    - `visitor_centers` object[]
      - `name` string
      - `open_today` boolean
      - `changes_on` string, date, nullable
      - `location` Location, nullable
        - `lat` number, required
        - `lon` number, required
    - `weather` union
      - Weather
        - `as_of` string, date-time, nullable, required: When it was read from the source (UTC)
        - `age_s` integer, nullable, required: Its age in seconds
        - `stale` boolean, required: Older than about three refreshes of its source
        - `model` unknown
        - `source` Source
          - `name` string, required
          - `url` string, uri
          - `license` string
        - `days` object[]
          - `date` string, date
          - `conditions` string
          - `max_c` number
          - `min_c` number
          - `snow_cm` number
          - `precip_chance` number: Percent
          - `precip_type` string
          - `sunrise_local` string
          - `sunset_local` string
        - `snow` object: Ski resorts: model snow at the lower and upper lift elevations
          - `glacier` boolean
          - `lower` SnowAt
            - `elevation_m` number
            - `depth_m` number, nullable: Absent on glaciers
            - `past_7d_cm` number
            - `past_30d_cm` number
            - `next_7d_cm` number
          - `upper` SnowAt
            - `elevation_m` number
            - `depth_m` number, nullable: Absent on glaciers
            - `past_7d_cm` number
            - `past_30d_cm` number
            - `next_7d_cm` number
      - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
        - `state` 'loading', required
    - `webcams` object
      - `live` union
        - Webcam[]
          - `name` string, required
          - `kind` 'official' | 'road' | 'nearby': official: the place's own; road: on an access road; nearby: towns and coast around. Not on ski resorts, whose two groups say it (ResortWebcams)
          - `image_url` string, uri, nullable: Full-size current still
          - `thumb_url` string, uri, nullable: Still at tile size (640 px)
          - `player_url` string, uri: Embeddable live player page
          - `hls_url` string, uri: Live HLS stream (road cameras)
          - `timelapse_url` string, uri: Embeddable day timelapse (Windy's)
          - `source_url` string, uri, nullable: The camera's own page
          - `credit` string, nullable
          - `km` number
          - `location` Location, nullable
            - `lat` number, required
            - `lon` number, required
          - `near` string: The lift or base it shows
          - `approx_location` boolean
          - `lift_line` boolean: A lift line is in view
        - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
          - `state` 'loading', required
      - `official` object[]
        - `title` string
        - `url` string, uri
    - `meta` Meta
      - `generated_at` string, date-time, required
      - `api_version` 'v1', required
      - `terms` string, uri, required
      - `attribution` string, required: Show this where you show the data
      - `sources` Source[], required
        - `name` string, required
        - `url` string, uri
        - `license` string
  - CanadaParkStatus
    - `park` object
      - `id` string
      - `name` string
      - `country` 'United States' | 'Canada'
      - `designation` string
      - `regions` string[]
      - `location` Location, nullable
        - `lat` number, required
        - `lon` number, required
      - `url` string, uri
      - `api_url` string, uri
      - `website` string, uri
    - `bulletins` object, nullable
      - `state` string
      - `items` object[]
        - `title` string
        - `date` string
        - `url` string, uri
    - `access_roads` union
      - Roads
        - `as_of` string, date-time, nullable, required: When it was read from the source (UTC)
        - `age_s` integer, nullable, required: Its age in seconds
        - `stale` boolean, required: Older than about three refreshes of its source
        - `state` 'reported' | 'source_error'
        - `source` Source
          - `name` string, required
          - `url` string, uri
          - `license` string
        - `items` object[]
          - `road` string
          - `clear` boolean: No restriction
          - `text` string: The source's own words
          - `code` string: e.g. Caltrans chain control R-2
          - `since` string
      - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
        - `state` 'loading', required
    - `weather_alerts` union
      - object[]
        - `event` string
        - `type` string
        - `area` string
        - `ends` string, nullable
      - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
        - `state` 'loading', required
    - `fire_hotspots` union
      - object
        - `count_24h_50km` integer
        - `nearest_km` number, nullable
      - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
        - `state` 'loading', required
    - `air` union
      - object
        - `us_aqi` integer
        - `pm25` number
        - `category` string
      - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
        - `state` 'loading', required
    - `weather` union
      - Weather
        - `as_of` string, date-time, nullable, required: When it was read from the source (UTC)
        - `age_s` integer, nullable, required: Its age in seconds
        - `stale` boolean, required: Older than about three refreshes of its source
        - `model` unknown
        - `source` Source
          - `name` string, required
          - `url` string, uri
          - `license` string
        - `days` object[]
          - `date` string, date
          - `conditions` string
          - `max_c` number
          - `min_c` number
          - `snow_cm` number
          - `precip_chance` number: Percent
          - `precip_type` string
          - `sunrise_local` string
          - `sunset_local` string
        - `snow` object: Ski resorts: model snow at the lower and upper lift elevations
          - `glacier` boolean
          - `lower` SnowAt
            - `elevation_m` number
            - `depth_m` number, nullable: Absent on glaciers
            - `past_7d_cm` number
            - `past_30d_cm` number
            - `next_7d_cm` number
          - `upper` SnowAt
            - `elevation_m` number
            - `depth_m` number, nullable: Absent on glaciers
            - `past_7d_cm` number
            - `past_30d_cm` number
            - `next_7d_cm` number
      - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
        - `state` 'loading', required
    - `webcams` object
      - `live` union
        - Webcam[]
          - `name` string, required
          - `kind` 'official' | 'road' | 'nearby': official: the place's own; road: on an access road; nearby: towns and coast around. Not on ski resorts, whose two groups say it (ResortWebcams)
          - `image_url` string, uri, nullable: Full-size current still
          - `thumb_url` string, uri, nullable: Still at tile size (640 px)
          - `player_url` string, uri: Embeddable live player page
          - `hls_url` string, uri: Live HLS stream (road cameras)
          - `timelapse_url` string, uri: Embeddable day timelapse (Windy's)
          - `source_url` string, uri, nullable: The camera's own page
          - `credit` string, nullable
          - `km` number
          - `location` Location, nullable
            - `lat` number, required
            - `lon` number, required
          - `near` string: The lift or base it shows
          - `approx_location` boolean
          - `lift_line` boolean: A lift line is in view
        - Loading: Not ready within ?wait_ms; still loading, ask again shortly.
          - `state` 'loading', required
      - `official` object[]
        - `title` string
        - `url` string, uri
    - `meta` Meta
      - `generated_at` string, date-time, required
      - `api_version` 'v1', required
      - `terms` string, uri, required
      - `attribution` string, required: Show this where you show the data
      - `sources` Source[], required
        - `name` string, required
        - `url` string, uri
        - `license` string

## Other responses

- `404`: Unknown id. `suggestions` lists close matches.
- `429`: Rate limited: 120 requests a minute per IP. Wait `Retry-After` seconds.

---

[API](https://skmtc.dev/status-live/apis/status-live-api.md) · [All operations](https://skmtc.dev/status-live/apis/status-live-api/llms.txt) · [OpenAPI document](https://skmtc.dev/status-live/apis/status-live-api/revisions/5fe517d19575?raw)