---
title: "Get router sandbox state"
method: GET
path: "/public/v2/routers/sandbox/state"
tags: ["Routers"]
---

# Get router sandbox state

`GET /public/v2/routers/sandbox/state`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/routers/sandbox/state`
- Auth: HTTP bearer

Required permission: Device command and configuration, View.<br/>Returns sandbox state and last hearbeat timestamp.

## Response `200`

Success

- SandboxStateResponseServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` SandboxStateResponse
    - `lastHeartbeatTimestamp` string, date-time, nullable: Last sandbox heartbeat stored for this account, in UTC. Null when no heartbeat has been stored.
    - `sandboxDisabled` boolean: True when sandboxing is disabled for this account. False when sandboxing is enabled.

## Other responses

- `401`: Must use a v2 service account
- `403`: Missing required permission for this endpoint or resource
- `422`: Failed to read sandbox state and last heartbeat timestamp

## Changes

- **2026-11-02** `dfd7014cfd6d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/starlink/apis/starlink-management-api/changes/public/v2/routers/sandbox/state/get.md)

---

[API](https://skmtc.dev/starlink/apis/starlink-management-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-management-api/revisions/dfd7014cfd6d?raw)