> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List sandboxes

> Returns the sandboxes owned by your live Plane workspace.

### Parameters

<ParamField query="limit" type="number">
  A limit on the number of objects to be returned. Limit can range between 1 and 100, and the
  default is 10.
</ParamField>

<ParamField query="cursor" type="string">
  A value from a previous response that lets you fetch the next page.
</ParamField>

<ParamField query="starting_after" type="string">
  Return results after this sandbox ID.
</ParamField>

<ParamField query="ending_before" type="string">
  Return results before this sandbox ID.
</ParamField>

### Returns

Only one of `cursor`, `starting_after`, or `ending_before` may be provided.

Returns a dictionary with a `sandboxes` property that contains an array of
[Sandbox](/reference/sandboxes-object) objects. When another page is available,
the response also includes a `cursor` value.

<ResponseExample>
  ```json Response theme={null}
  {
    "sandboxes": [
      {
        "id": "sbx_3vNqM7xRk2pWsT",
        "name": "Airfoil Sandbox",
        "status": "ready",
        "workspace": "wsp_4kW3GnQCo1CQ49",
        "sandbox_workspace": "wsp_test_9nD31mQzRa8kF2",
        "created": "2026-03-28T17:20:00Z",
        "updated": "2026-03-28T17:21:04Z"
      }
    ],
    "cursor": "WyIyMDI2LTAzLTI4VDE3OjIxOjA0LjAwMDAwMFoiLCJzYnhfM3ZOcU03eFJrMnBXc1QiXQ"
  }
  ```
</ResponseExample>