---
title: "Capture Semantic Segmentation"
method: GET
path: "/periphery/cameras/capture/semantic-segmentation"
tags: ["Periphery (Camera)"]
---

# Capture Semantic Segmentation

`GET /periphery/cameras/capture/semantic-segmentation`

Retrieves semantic segmentation data for specified object classes, with each detected entity uniquely labeled.
If no class is specified, data for all labeled objects in the scene is returned.

Use the `set_semantic_label` endpoint to assign labels to scene entities.

## Query parameters

- `result_type` 'json' | 'rgb_png', required — Format which will be used to represent the captured data
- `object_class` string[] — The class of the object for which the data is to be fetched. If no labels are set in the scene, all bounding boxes could be returned.
- `camera_prim_path` string, required — Path of camera prim
- `width` integer — Image width in px
- `height` integer — Image height in px

## Response `200`

Successfully fetched semantic segmentation data

- SemanticSegmentationData
  - `data` array[], required — Pixel-to-label array
    - integer[]
  - `info` SemanticSegmentationInfo, required
    - `id_to_labels` object, required — Mapping of semantic IDs to their class labels and attributes

## Other responses

- `404` — Camera not configured
- `422` — Validation Error
- `500` — Could not fetch segmentation data

---

[API](https://skmtc.net/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api.md) · [All operations](https://skmtc.net/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wandelbotsgmbh/wandelbots-nova-isaac-sim-extension-api/versions/a0efd7dad77c/schema)