---
title: "GET /webcams"
method: GET
path: "/webcams"
tags: ["webcams"]
---

# GET /webcams

`GET /webcams`

## Request

- Base URL: `https://developer.nps.gov/api/v1`
- URL: `https://developer.nps.gov/api/v1/webcams`
- Auth: one of:
  - API key in query parameter `api_key`
  - API key in header `X-Api-Key`

Returns metadata for National Park Service webcams, with optional filters for park codes, state codes, webcam IDs, or a search term.

## Query parameters

- `parkCode` string[]
- `stateCode` string[]
- `id` string
- `limit` integer
- `start` integer
- `q` string

## Response `200`

successful operation

- Webcams
  - `total` string
  - `data` object[]
    - `url` string: URL corresponding to this webcam
    - `title` string
    - `geometryPoiId` string: Id for Geometry Point of Interest
    - `id` string
    - `description` string
    - `images` object[]
      - `url` string
      - `credit` string
      - `altText` string
      - `title` string
      - `description` string
      - `caption` string
      - `crops` object[]
        - `aspectRatio` number
        - `url` string
    - `relatedParks` object[]
      - `states` string
      - `parkCode` string
      - `designation` string
      - `fullName` string
      - `url` string
      - `name` string
    - `status` string
    - `statusMessage` string
    - `isStreaming` boolean
    - `tags` string[]
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `credit` string
  - `limit` string
  - `start` string

## Other responses

- `400`: Invalid status value

---

[API](https://skmtc.dev/nps/apis/national-park-service.md) - [All operations](https://skmtc.dev/nps/apis/national-park-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nps/apis/national-park-service/revisions/f1704d8b8142?raw)