---
title: "List reserves"
method: GET
path: "/reserves"
tags: ["reserve"]
---

# List reserves

`GET /reserves`

Optional `type` filters by reserve type. Optional `startDate` and/or `endDate` restrict to reserves whose period overlaps that window (reserve.startDate <= filter.endDate AND reserve.endDate >= filter.startDate when both are set). Omit date filters to ignore period. Each row includes `logoUrl`, a time-limited presigned URL for the reserve logo (null when the reserve has none), so clients do not need the per-reserve logo-url endpoints.

## Query parameters

- `type` 1 | 2 | 3
- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

Matching reserves

- ReserveListItemDto[]
  - `logoUrl` string, nullable, required — Time-limited presigned URL for the reserve logo, or null when the reserve has none (Railway buckets are private)

## Other responses

- `400` — Invalid query parameters
- `401` — Unauthorized
- `403` — Forbidden — Admin role required

---

[API](https://skmtc.dev/dre/apis/dre-api.md) · [All operations](https://skmtc.dev/dre/apis/dre-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dre/dre-api/revisions/5d14beb9482b/schema)
