---
title: "Get Detailed Camera Information"
method: GET
path: "/api/v1/camera/info"
tags: ["v1", "camera"]
---

# Get Detailed Camera Information

`GET /api/v1/camera/info`

Get comprehensive camera information including all detected 
devices and capabilities.

This endpoint provides detailed analysis of all available USB cameras including complete 
device enumeration via v4l2, hardware specifications with device names and drivers, format 
capabilities for supported video formats and resolutions, and primary camera selection with 
system recommendations.

## Information Categories

When camera is currently streaming, the system provides active camera status with current 
device and format information plus all detected cameras for complete device reference. 
When no camera is actively streaming, the system returns all cameras with complete device 
enumeration, primary camera selection with system recommendations, and capability analysis 
with detailed format and resolution support.

This endpoint is essential for applications requiring detailed camera analysis or 
multi-camera management.

## Response `200`

Camera information retrieved successfully

- CameraInfoResponse — Response for GET /camera/info endpoint
  - `connected` boolean, required — Whether any camera is connected
  - `message` string, required — Information message
  - `active_camera` ActiveCameraStatus — Status of currently active camera
    - `device_path` string, required — Active camera device path
    - `streaming` boolean, required — Whether camera is currently streaming
    - `current_format` CameraFormatDetail — Camera format with resolution and framerate details
      - `format` 'MJPG' | 'YUYV' | 'H264' | 'UYVY', required — Supported video formats
      - `width` integer, required — Frame width in pixels
      - `height` integer, required — Frame height in pixels
      - `fps` number, required — Frames per second
    - `settings` object, nullable — Current camera settings
  - `all_cameras` CameraDevice[], nullable — All detected cameras when one is active
    - `device_name` string, required — Camera device name
    - `bus_info` string, required — USB bus information
    - `device_path` string, required — Device path (e.g., /dev/video0)
    - `card_name` string, required — Camera card name
    - `driver_name` string, required — Camera driver name
    - `supported_formats` SupportedFormat[] — All supported formats and resolutions
      - `format` 'MJPG' | 'YUYV' | 'H264' | 'UYVY', required — Supported video formats
      - `description` string, required — Human-readable format description
      - `resolutions` ResolutionDetail[], required — Supported resolutions for this format
        - `width` integer, required — Frame width in pixels
        - `height` integer, required — Frame height in pixels
        - `framerates` number[], required — Supported framerates for this resolution
    - `best_format` CameraFormatDetail — Camera format with resolution and framerate details
      - `format` 'MJPG' | 'YUYV' | 'H264' | 'UYVY', required — Supported video formats
      - `width` integer, required — Frame width in pixels
      - `height` integer, required — Frame height in pixels
      - `fps` number, required — Frames per second
  - `cameras` CameraDevice[], nullable — All detected camera devices
    - `device_name` string, required — Camera device name
    - `bus_info` string, required — USB bus information
    - `device_path` string, required — Device path (e.g., /dev/video0)
    - `card_name` string, required — Camera card name
    - `driver_name` string, required — Camera driver name
    - `supported_formats` SupportedFormat[] — All supported formats and resolutions
      - `format` 'MJPG' | 'YUYV' | 'H264' | 'UYVY', required — Supported video formats
      - `description` string, required — Human-readable format description
      - `resolutions` ResolutionDetail[], required — Supported resolutions for this format
        - `width` integer, required — Frame width in pixels
        - `height` integer, required — Frame height in pixels
        - `framerates` number[], required — Supported framerates for this resolution
    - `best_format` CameraFormatDetail — Camera format with resolution and framerate details
      - `format` 'MJPG' | 'YUYV' | 'H264' | 'UYVY', required — Supported video formats
      - `width` integer, required — Frame width in pixels
      - `height` integer, required — Frame height in pixels
      - `fps` number, required — Frames per second
  - `primary_camera` CameraDevice — Individual camera device information
    - `device_name` string, required — Camera device name
    - `bus_info` string, required — USB bus information
    - `device_path` string, required — Device path (e.g., /dev/video0)
    - `card_name` string, required — Camera card name
    - `driver_name` string, required — Camera driver name
    - `supported_formats` SupportedFormat[] — All supported formats and resolutions
      - `format` 'MJPG' | 'YUYV' | 'H264' | 'UYVY', required — Supported video formats
      - `description` string, required — Human-readable format description
      - `resolutions` ResolutionDetail[], required — Supported resolutions for this format
        - `width` integer, required — Frame width in pixels
        - `height` integer, required — Frame height in pixels
        - `framerates` number[], required — Supported framerates for this resolution
    - `best_format` CameraFormatDetail — Camera format with resolution and framerate details
      - `format` 'MJPG' | 'YUYV' | 'H264' | 'UYVY', required — Supported video formats
      - `width` integer, required — Frame width in pixels
      - `height` integer, required — Frame height in pixels
      - `fps` number, required — Frames per second
  - `total_cameras` integer, nullable — Total number of cameras detected
  - `cameras_found` CameraDevice[], nullable — Cameras found (may be empty)
    - `device_name` string, required — Camera device name
    - `bus_info` string, required — USB bus information
    - `device_path` string, required — Device path (e.g., /dev/video0)
    - `card_name` string, required — Camera card name
    - `driver_name` string, required — Camera driver name
    - `supported_formats` SupportedFormat[] — All supported formats and resolutions
      - `format` 'MJPG' | 'YUYV' | 'H264' | 'UYVY', required — Supported video formats
      - `description` string, required — Human-readable format description
      - `resolutions` ResolutionDetail[], required — Supported resolutions for this format
        - `width` integer, required — Frame width in pixels
        - `height` integer, required — Frame height in pixels
        - `framerates` number[], required — Supported framerates for this resolution
    - `best_format` CameraFormatDetail — Camera format with resolution and framerate details
      - `format` 'MJPG' | 'YUYV' | 'H264' | 'UYVY', required — Supported video formats
      - `width` integer, required — Frame width in pixels
      - `height` integer, required — Frame height in pixels
      - `fps` number, required — Frames per second

## Other responses

- `401` — Authentication required
- `500` — Camera initialization or operation failed

---

[API](https://skmtc.net/reach-systems-tech/apis/reelapi-v1.md) · [All operations](https://skmtc.net/reach-systems-tech/apis/reelapi-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reach-systems-tech/reelapi-v1/revisions/1dd366a9c6a3/schema)