---
title: "Get Supported Resolutions"
method: GET
path: "/api/v1/camera/supported-resolutions"
tags: ["v1", "camera"]
---

# Get Supported Resolutions

`GET /api/v1/camera/supported-resolutions`

Get supported camera resolutions and video formats 
using v4l2 detection.

This endpoint provides comprehensive camera capability information including resolution 
enumeration for all supported image sizes, framerate details with available rates for 
each resolution, format capabilities for supported video formats like MJPEG and YUYV, 
and optimization recommendations for best format selection.

## Detection Methods

When camera is currently streaming, the system provides active camera query with 
real-time capability information from the active device. When no camera is actively 
streaming, the system performs v4l2 static detection with complete capability scan 
using the v4l2 interface.

## Format Categories

The system supports MJPEG compressed formats for efficient streaming applications 
and YUYV uncompressed formats for processing applications requiring raw video data.

## Integration Recommendations

Check supported resolutions before starting streams for pre-streaming validation, 
adjust resolution based on network conditions for dynamic adaptation, and cache 
resolution data to avoid repeated queries for capability caching optimization.

## Response `200`

Supported resolutions retrieved successfully

- SupportedResolutionsResponse — Response for GET /camera/supported-resolutions endpoint
  - `device` string, required — Camera device path
  - `supported_resolutions` ResolutionDetail[], required — List of supported resolutions
    - `width` integer, required — Frame width in pixels
    - `height` integer, required — Frame height in pixels
    - `framerates` number[], required — Supported framerates for this resolution
  - `source` string, required — Source of resolution data (active_camera or v4l2_detection)
  - `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
  - `device_name` string, nullable — Camera device name
  - `supported_formats` SupportedFormat[], nullable — All supported formats
    - `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
- `404` — No USB cameras available
- `422` — Invalid camera format or settings
- `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/versions/1dd366a9c6a3/schema)