---
title: "Read Camera"
method: GET
path: "/api/v1/devices/{device_id}/camera"
tags: ["device camera"]
---

# Read Camera

`GET /api/v1/devices/{device_id}/camera`

## Request

- Base URL: `https://api.brumby.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brumby.com/api/v1/devices/{device_id}/camera`
- Auth: HTTP bearer

Resolve a play descriptor for one of the device's two cameras: ``mast``
(the trailer's IP camera, the default) or ``aircraft`` (the ZT6 through the
HM30). Never 404s: an unconfigured or offline device is a valid answer the
panel renders as its placeholder, not an error.

## Path parameters

- `device_id` string, required

## Query parameters

- `view` 'mast' | 'aircraft'

## Response `200`

Successful Response

- CameraFeedResponse: How the cockpit plays one device's camera. See services/camera.py.
  - `available` boolean, required
  - `transport` 'whep' | 'mjpeg', nullable, required
  - `url` string, nullable, required
  - `token` string, nullable, required
  - `expires_at` string, date-time, nullable, required
  - `streaming` boolean, required
  - `source` string, nullable, required
  - `label` string, nullable, required
  - `latency_ms` number, nullable, required
  - `bitrate_kbps` number, nullable, required
  - `reason` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brumby/apis/brumby-platform-api.md) - [All operations](https://skmtc.dev/brumby/apis/brumby-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brumby/apis/brumby-platform-api/revisions/fe185e20813e?raw)