---
title: "List Ghost Objects"
method: GET
path: "/teaching/ghost-objects"
tags: ["Teaching"]
---

# List Ghost Objects

`GET /teaching/ghost-objects`

Fetches all ghost objects defined in the scene

## Query parameters

- `relative_to_prim` string — Prim path to which the ghost object poses are relative

## Response `200`

Successfully fetched all the ghost objects in the scene

- GhostObject[]
  - `name` string, required
  - `prim_path` string, required
  - `robot_prim_path` string, nullable, required
  - `pose` WSPose, required
    - `pose` number[] — Pose in rotation vector format (WS)
  - `preferred_joint_values` number[], nullable

## Other responses

- `422` — Validation Error
- `500` — Unable to fetch all the ghost objects in the scene

## Changes

- **2026-04-13** `325edd10e0bd` — 1 info
  - added the optional property `items/preferred_joint_values` to the response with the `200` status
- **2025-12-02** `1c198c91dc8e` — 1 warning
  - removed the optional property `items/preferred_joint_values` from the response with the `200` status

[Change history](https://skmtc.dev/wandelbotsgmbh/apis/wandelbots-nova-isaac-sim-extension-api/changes/teaching/ghost-objects/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-service-production.skmtc.workers.dev/v1/apis/wandelbotsgmbh/wandelbots-nova-isaac-sim-extension-api/revisions/a0efd7dad77c/schema)