Skip to main content
GET
/
api
/
capacity
/
reservations
List Reservations
curl --request GET \
  --url https://app.opencomputer.dev/api/capacity/reservations \
  --header 'X-API-Key: <api-key>'
{
  "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
}
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.
​
from
string
required
Return reservations whose createdAt >= from. RFC 3339, UTC.
​
to
string
required
Return reservations whose createdAt < to. RFC 3339, UTC.
​
cursor
string
Pagination cursor from a previous response’s nextCursor.
​
limit
integer
Maximum reservations per page. Server-defined ceiling applies.
{
  "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
}