---
title: "Capture Color Image"
method: GET
path: "/periphery/cameras/capture/color"
tags: ["Periphery (Camera)"]
---

# Capture Color Image

`GET /periphery/cameras/capture/color`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/docs/periphery/cameras/capture/color/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the raw RGB color image from the camera's point of view.

- Returns the frame as PNG (lossless, the default) or as jpeg, which is a
  fraction of the size when the camera is polled rather than sampled once.
- There is no json form: a colour frame as an array of pixels would be
  megabytes with nothing to read it.

## Query parameters

- `result_type` 'rgb_png' | 'jpeg': Image format the frame is returned in.
- `camera_prim_path` string, nullable: Path of camera prim. Leave it out to capture through the active viewport camera.
- `width` integer: Image width in px
- `height` integer: Image height in px

## Response `200`

Successfully fetched color image from camera

## Other responses

- `404`: Camera not configured
- `422`: Validation Error
- `500`: Could not fetch color image

## Changes

> 15 revisions in range; 1 not diffed.

- **2026-09-24** `f4e4cbd85f5b`: 5 info
  - added the new optional `query` request parameter `result_type`
  - the `query` request parameter `camera_prim_path` became optional
  - `query` request parameter `camera_prim_path` list-of-types was widened by adding types `null`
  - for the `query` request parameter `camera_prim_path`, the type was generalized from `string` to no type
  - …1 more

[Operation history](https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/changes/periphery/cameras/capture/color/get.md)

---

[API](https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api.md) - [All operations](https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/revisions/9f8bd1420bcf?raw)