---
title: "Get vehicle power status"
method: GET
path: "/v1/vehicles/{vehicleId}/power/status"
tags: ["Power"]
---

# Get vehicle power status

`GET /v1/vehicles/{vehicleId}/power/status`

Returns the vehicle's most recently reported power state and any pending power command.

## Path parameters

- `vehicleId` string, required

## Response `200`

The vehicle's most recently reported power state.

- PowerStatusResponse
  - `status` 'success', required
  - `data` PowerStatus, required
    - `state` 'on' | 'off' | 'unknown', required — The vehicle's most recently reported power state.
    - `pendingCommand` PowerPendingCommand, nullable, required — A power command that Polymath accepted but the vehicle has not completed, or `null` if no command is pending.
      - `state` 'on' | 'off', required — The power state requested by the pending command.
    - `updatedAt` string, date-time, nullable, required — When the vehicle's power state was last reported, or `null` if no state has been reported.

## Other responses

- `401` — The request is missing a bearer token, or the token is invalid.
- `403` — The bearer token does not grant access to this operation or vehicle.
- `404` — The vehicle was not found, is not available to this API client, or does not support power control.
- `500` — Polymath could not complete the request because of an unexpected error.
- `502` — Polymath could not complete the request because another service failed.
- `503` — The requested operation is temporarily unavailable.
- `504` — Polymath did not receive a response in time.

---

[API](https://skmtc.dev/polymathrobotics/apis/polymath-api.md) · [All operations](https://skmtc.dev/polymathrobotics/apis/polymath-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/polymathrobotics/polymath-api/revisions/5a30708786fa/schema)