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

# List sandboxes

> Returns all sandboxes, optionally filtered by organization

Returns all sandboxes, optionally filtered by organization

### Query parameters

<ParamField query="org_id" type="string">
  Filter by organization ID
</ParamField>

### Response

`object`

<ResponseField name="sandboxes" type="SandboxSummary[]">
  <Expandable title="SandboxSummary">
    <ResponseField name="sandbox_id" type="string (uuid)" />

    <ResponseField name="org_id" type="string" />

    <ResponseField name="session_id" type="string" />

    <ResponseField name="status" type="SandboxStatusEnum" />

    <ResponseField name="created_at" type="string (date-time)" />

    <ResponseField name="expires_at" type="string (date-time)" />
  </Expandable>
</ResponseField>

### Status codes

| Code  | Meaning           |
| ----- | ----------------- |
| `200` | List of sandboxes |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.sandbox.stateset.app/api/v1/sandboxes' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "sandboxes": [
      {
        "sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "org_id": "string",
        "session_id": "string",
        "status": "creating",
        "created_at": "2026-07-24T12:00:00Z",
        "expires_at": "2026-07-24T12:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>