---
title: "List reservations"
method: GET
path: "/api/reservations"
tags: ["Reservations"]
---

# List reservations

`GET /api/reservations`

## Request

- Base URL: `https://api.hotelumo.com`
- URL: `https://api.hotelumo.com/api/reservations`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

Lists the reservations of your organization. Optionally filter by `hotelId`, `guestId`, a legacy `startTime`/`endTime` window, or an overlapping stay window with `stayDateFrom`/`stayDateTo`. Requires the `reservations:read` scope.

## Query parameters

- `hotelId` string
- `guestId` string
- `startTime` string
- `endTime` string
- `stayDateFrom` string, date
- `stayDateTo` string, date
- `limit` integer
- `skip` integer
- `sortField` string
- `sortDirection` 'ASC' | 'DESC'
- `fields` string

## Response `200`

Array of reservations

## Other responses

- `401`: Missing or invalid credentials
- `403`: API key is missing the `reservations:read` scope
- `429`: API key rate limit exceeded

---

[API](https://skmtc.dev/hotelumo/apis/hotelumo-api.md) · [All operations](https://skmtc.dev/hotelumo/apis/hotelumo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hotelumo/apis/hotelumo-api/revisions/459a91d5cb0c?raw)