---
title: "Get a webcam"
method: GET
path: "/webcams/{id}"
tags: ["Webcams"]
---

# Get a webcam

`GET /webcams/{id}`

## Request

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

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `webcam` CatalogWebcam
    - `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
    - `id` string, required
    - `name` string, required
    - `kind` 'still' | 'hls' | 'embed' | 'page', required: still: an image URL; hls: a live stream; embed: a player page; page: a page with the camera
    - `status` 'working' | 'frozen' | 'offline' | 'unverified' | 'unchecked', required
    - `last_ok` string, date-time, nullable
    - `last_changed` string, date-time, nullable: When its image last changed between checks
    - `reason` string: Why it is not working, e.g. "placeholder card"
    - `location` Location, nullable, required
      - `lat` number, required
      - `lon` number, required
    - `km` number: From `near`
    - `country` string, nullable
    - `region` string, nullable
    - `area` string, nullable
    - `route` string, nullable
    - `direction` string, nullable
    - `tags` string[]
    - `image_url` string, uri, nullable
    - `hls_url` string, uri, nullable
    - `player_url` string, uri, nullable
    - `page_url` string, uri, nullable
    - `near` object
      - `ski_resort` object
        - `id` string
        - `km` number, nullable
        - `api_url` string, uri
    - `license` string, required
    - `attribution` string, required: Show this with the image
    - `url` string, uri, nullable
    - `api_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)