> ## Documentation Index
> Fetch the complete documentation index at: https://opensandbox-oc-s-762ac928075c46d2828bcb22.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Reservations

Return reservation events made by the authenticated org, in
reverse-chronological order by `createdAt`. Each reservation row includes
all the intervals it committed to. Useful for end-of-month reconciliation
and audit.

<ParamField query="from" type="string" required>
  Return reservations whose `createdAt >= from`. RFC 3339, UTC.
</ParamField>

<ParamField query="to" type="string" required>
  Return reservations whose `createdAt < to`. RFC 3339, UTC.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor from a previous response's `nextCursor`.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum reservations per page. Server-defined ceiling applies.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "from": "2026-04-01T00:00:00Z",
    "to":   "2026-05-01T00:00:00Z",
    "reservations": [
      {
        "reservationId": "9f67b8f7-7b91-4d2d-b1cb-19d0d0a14562",
        "createdAt": "2026-04-28T18:00:05Z",
        "intervals": [
          {
            "startsAt": "2026-04-29T02:00:00Z",
            "endsAt":   "2026-04-29T02:15:00Z",
            "capacityGb": 16
          },
          {
            "startsAt": "2026-04-29T02:15:00Z",
            "endsAt":   "2026-04-29T02:30:00Z",
            "capacityGb": 16
          }
        ]
      }
    ],
    "nextCursor": null
  }
  ```
</ResponseExample>