---
title: "Get Full State"
method: GET
path: "/api/state/full"
---

# Get Full State

`GET /api/state/full`

Get the full robot state, with optional fields.

## Query parameters

- `with_control_mode` boolean
- `with_head_pose` boolean
- `with_target_head_pose` boolean
- `with_head_joints` boolean
- `with_target_head_joints` boolean
- `with_body_yaw` boolean
- `with_target_body_yaw` boolean
- `with_antenna_positions` boolean
- `with_target_antenna_positions` boolean
- `with_passive_joints` boolean
- `with_doa` boolean
- `use_pose_matrix` boolean

## Response `200`

Successful Response

- FullState — Represent the full state of the robot including all joint positions and poses.
  - `control_mode` 'enabled' | 'disabled' | 'gravity_compensation' — Enum for motor control modes.
  - `head_pose` union
    - XYZRPYPose — Represent a 3D pose using position (x, y, z) in meters and orientation (roll, pitch, yaw) angles in radians.
      - `x` number
      - `y` number
      - `z` number
      - `roll` number
      - `pitch` number
      - `yaw` number
    - Matrix4x4Pose — Represent a 3D pose by its 4x4 transformation matrix (translation is expressed in meters).
      - `m` unknown[], required
        - unknown
  - `head_joints` number[], nullable
  - `body_yaw` number, nullable
  - `antennas_position` number[], nullable
  - `timestamp` string, date-time, nullable
  - `passive_joints` number[], nullable
  - `doa` DoaSnapshot — Sound Direction of Arrival reading (ReSpeaker mic array). ``angle`` is in radians: 0 = left, π/2 = front, π = right.
    - `angle` number, required
    - `speech_detected` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pollen-robotics/apis/reachy-mini-rest-api.md) · [All operations](https://skmtc.net/pollen-robotics/apis/reachy-mini-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pollen-robotics/reachy-mini-rest-api/versions/9843f2902e88/schema)