---
title: "Search published rentals"
method: GET
path: "/rentals"
---

# Search published rentals

`GET /rentals`

## Request

- Base URL: `https://elron.club/api/public/v1`
- URL: `https://elron.club/api/public/v1/rentals`
- Auth: none declared

## Query parameters

- `locale` 'de' | 'en'
- `q` string
- `city` string
- `region` string
- `availableFrom` string
- `availabilityStatus` 'AVAILABLE_OR_UPCOMING' | 'AVAILABLE' | 'UPCOMING' | 'UNAVAILABLE' | 'ANY'
- `minimumRooms` number
- `minimumOccupancy` number
- `maximumMonthlyRent` number
- `durationMonths` 3 | 6 | 12
- `limit` integer

## Response `200`

Bounded published rental results

- RentalSearchResult
  - `schemaVersion` '2026-07-13', required
  - `generatedAt` string, date-time, required
  - `count` integer, required
  - `total` integer, required
  - `hasMore` boolean, required
  - `rentals` RentalSearchItem[], required
    - `schemaVersion` '2026-07-13', required
    - `rentalId` string, required
    - `canonicalUrl` string, uri, required
    - `locale` 'de' | 'en', required
    - `title` string, required
    - `summary` string, nullable, required
    - `location` RentalSearchLocation, required
      - `propertyName` string, required
      - `city` string, required
      - `region` string, required
      - `postalCode` string, nullable, required
      - `countryCode` string, nullable, required
    - `apartment` RentalApartment, required
      - `label` string, nullable, required
      - `rooms` number, nullable, required
      - `areaSquareMeters` number, nullable, required
      - `maximumOccupancy` integer, nullable, required
      - `floor` string, nullable, required
      - `furnished` boolean, required
    - `availability` RentalAvailability, required
      - `status` 'AVAILABLE' | 'UPCOMING' | 'UNAVAILABLE', required
      - `availableFrom` string, date, nullable, required
      - `verifiedAt` string, date-time, required
      - `canStartInquiry` boolean, required
    - `pricing` RentalSearchPricing, required
      - `currency` 'CHF', required
      - `monthlyByDuration` RentalDurationPrice[], required
        - `durationMonths` 3 | 6 | 12, required
        - `monthlyRent` number, required
      - `parkingMonthly` number, nullable, required
      - `deposit` string, nullable, required
    - `terms` RentalSearchTerms, required
      - `minimumStayMonths` integer, nullable, required
      - `noticePeriod` string, nullable, required
      - `registrationPossible` boolean, nullable, required
      - `petsAllowed` boolean, nullable, required
    - `amenities` string[], required
    - `links` RentalLinks, required
      - `inquiry` string, uri, nullable, required
      - `application` string, uri, nullable, required

## Other responses

- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/elron/apis/elron-club-public-rental-api.md) · [All operations](https://skmtc.dev/elron/apis/elron-club-public-rental-api/llms.txt) · [OpenAPI document](https://skmtc.dev/elron/apis/elron-club-public-rental-api/revisions/c28843a497a2?raw)