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

# list_sandboxes

List your company's sandboxes — copies of its real compensation data.

A sandbox is used to design and test compensation without touching the real
data: it has its own plans, quotas, statements and reports. Call this to learn
which sandboxes exist, then pass one's id as the `environment` argument of
another tool to read that sandbox.

Every tool reads the company's real data unless you pass such an id, so you only
need this when the question is explicitly about a sandbox. Rows carry no deep
link: the web app has no sandbox page — it switches from its own selector.

Takes no arguments; deleted sandboxes are never returned.

## Response

<Accordion title="Body" defaultOpen>
  <ResponseField name="sandboxes" type="object[]">
    <Expandable title="object properties">
      <ResponseField name="id" type="string">
        Pass this id as the `environment` argument of another tool to read that
        tool's resources inside this sandbox.
      </ResponseField>

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

      <ResponseField name="ready" type="boolean">
        Whether the sandbox holds usable data. A freshly created one is still
        being duplicated and reads as not ready; passing its id to another tool
        is refused until it flips.
      </ResponseField>

      <ResponseField name="reporting_available" type="boolean">
        Whether reports and dashboards can be read in this sandbox. False for a
        sandbox created without reporting, or whose reporting duplication is not
        published yet — the report tools refuse such a sandbox while the other
        tools still serve it.
      </ResponseField>

      <ResponseField name="calculation_start_period" type="string">
        First period the sandbox computes statements for, as `YYYY-MM`. Null
        when the sandbox carries no period window.
      </ResponseField>

      <ResponseField name="calculation_end_period" type="string">
        Last period the sandbox computes statements for, as `YYYY-MM`. Outside
        this window the sandbox holds no statement.
      </ResponseField>
    </Expandable>
  </ResponseField>
</Accordion>