---
title: "POST /v0/robot-system-info/get"
method: POST
path: "/v0/robot-system-info/get"
tags: ["Robot System"]
---

# POST /v0/robot-system-info/get

`POST /v0/robot-system-info/get`

## Request

- Base URL: `https://api.bearrobotics.ai`
- URL: `https://api.bearrobotics.ai/v0/robot-system-info/get`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bearrobotics/apis/bear-cloud-api/docs/v0/robot-system-info/get/post.ts> (a function with typed inputs; its response is checked against the schema)

Get the overall robot system information.

 When called, the server returns robot system information. The system info
 tends to be static and does not change often.

## Request body

- object
  - `robotId` string, required

## Response `200`

OK

- GetRobotSystemInfoResponse
  - `systemInfo` SystemInfo: SystemInfo contains various system-level data of a robot.
    - `softwareVersion` string: The distribution version currently installed and running on the robot. e.g. "servi-24.03"
    - `robotFamily` integer
    - `robotId` string: Unique identifier for the robot. e.g. "pennybot-abc123"
    - `displayName` string: A user-friendly name for the robot, typically used for display purposes.

## Other responses

- `400`: Bad Request, usually caused by malfored request body.
- `401`: Unauthorized credentials, ensure the JWT is correct and up to date.
- `500`: Internal Server Error
- `503`: Service is temporarily unavailable, which can usually be resolved by backoff retries.
- `504`: Server-side timeout, usually caused by the failure to send/receive commands/responses to the designated robot.

---

[API](https://skmtc.dev/bearrobotics/apis/bear-cloud-api.md) - [All operations](https://skmtc.dev/bearrobotics/apis/bear-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bearrobotics/apis/bear-cloud-api/revisions/b90843b624b5?raw)