---
title: "Get state of Pica itself"
method: GET
path: "/get-state"
tags: ["Commands"]
---

# Get state of Pica itself

`GET /get-state`

Get the state of Pica itself and return a list of connected Devices

## Response `200`

Success, return a list of Devices

- Device[]
  - `category` 'uci' | 'anchor' — Represents the device's category, uci or anchor.
  - `mac_address` string — Valid UWB mac addresses must follow the above format * Short Mode: "XX:XX" * Extend Mode: "XX:XX:XX:XX:XX:XX:XX:XX" where X is an hexadecimal number.
  - `position` Position — The position includes the Cartesian coordinates in cm, and the yaw, pitch, roll angles in degrees.
    - `x` integer — x coordinate in cm
    - `y` integer — y coordinate in cm
    - `z` integer — z coordinate in cm
    - `yaw` integer — yaw in degrees
    - `pitch` integer — pitch in degrees
    - `roll` integer — roll in degrees

## Other responses

- `500` — Internal error

## Changes

- **2026-07-17** `7e54e3f9ba25` — 3 warning, 3 info
  - removed the optional property `items/Category` from the response with the `200` status
  - removed the optional property `items/MacAddress` from the response with the `200` status
  - removed the optional property `items/Position` from the response with the `200` status
  - added the optional property `items/category` to the response with the `200` status
  - …2 more
- **2022-08-22** `657e36b2039b` — 6 breaking
  - the `items/Position/pitch` response's property type/format changed from `integer`/`` to `number`/`` for status `200`
  - the `items/Position/roll` response's property type/format changed from `integer`/`` to `number`/`` for status `200`
  - the `items/Position/x` response's property type/format changed from `integer`/`` to `number`/`` for status `200`
  - the `items/Position/y` response's property type/format changed from `integer`/`` to `number`/`` for status `200`
  - …2 more
- **2022-08-05** `657e36b2039b` — 3 warning, 3 info
  - removed the optional property `items/category` from the response with the `200` status
  - removed the optional property `items/mac_address` from the response with the `200` status
  - removed the optional property `items/position` from the response with the `200` status
  - added the optional property `items/Category` to the response with the `200` status
  - …2 more

[Change history](https://skmtc.dev/google/apis/pica-a-platform-agnostic-uwb-virtual-controller/changes/get-state/get.md)

---

[API](https://skmtc.dev/google/apis/pica-a-platform-agnostic-uwb-virtual-controller.md) · [All operations](https://skmtc.dev/google/apis/pica-a-platform-agnostic-uwb-virtual-controller/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/pica-a-platform-agnostic-uwb-virtual-controller/revisions/7e54e3f9ba25/schema)