---
title: "Search"
method: GET
path: "/search"
---

# Search

`GET /search`

## Request

- Base URL: `https://rooms.aero/partnerapi`
- URL: `https://rooms.aero/partnerapi/search`
- Auth: API key in header `Partner-Authorization`

The Search page as an API: for an area and a range of check-in dates, every hotel with an award starting in that range and its cheapest standard and suite rates, cheapest award first. Give the area as a bounding box or as a place name to geocode. Areas are limited to 500 hotels; narrow the box or filter by source for dense cities.

## Query parameters

- `start_date` string, required
- `end_date` string, required
- `sw_lat` number
- `sw_lng` number
- `ne_lat` number
- `ne_lng` number
- `location` string
- `nights` integer
- `source` string
- `max_points` integer
- `min_cpp` number
- `skip` integer
- `take` integer

## Response `200`

200

- SearchResultList: A page of matching hotels, cheapest award first.
  - `data` SearchResult[]
    - `hotel` Hotel: One property in one loyalty program. The same object is returned by every endpoint that mentions a hotel.
      - `id` string: rooms.aero's identifier for the hotel. Use it as hotel_id on the other endpoints.
      - `source` string: The loyalty program key. The keys are listed on the Concepts page.
      - `program` string: The loyalty program's display name.
      - `name` string: Hotel name.
      - `brand` string: Program-specific brand code. The Concepts page maps codes to names.
      - `award_category` string: Program-specific award category, for programs with an award chart. Empty otherwise.
      - `address` string: Street address as published by the program.
      - `city` string: City.
      - `state` string: State, province or region; may be empty.
      - `country` string: Country, as a display name.
      - `latitude` number: Latitude in decimal degrees.
      - `longitude` number: Longitude in decimal degrees.
      - `image_url` string: A representative photo, when the program publishes one.
      - `description` string: Short description from the program; may be empty.
      - `internal_id` string: The program's own property code (Hilton ctyhocn, Hyatt spirit code, Marriott property code, and so on).
      - `open` boolean: Whether the property is open.
      - `url` string: The hotel's page on rooms.aero.
      - `lowest_award` integer, nullable: The cheapest award, in points, seen for any upcoming date in the last two weeks. Null when none is known. Populated by Get Hotels and Search; omitted from availability rows.
      - `standard_award_availability_percent` integer, nullable: Share of checked upcoming dates with any award available, over standard_award_availability_window_days. Null until enough dates have been checked.
      - `standard_award_availability_window_days` integer, nullable: The window the percentage was measured over.
      - `standard_award_availability_updated_at` string, date-time, nullable: When the percentage was last recomputed. RFC 3339 timestamp.
      - `last_checked_at` string, date-time, nullable: When the property's rates were last retrieved. Null if never. RFC 3339 timestamp.
      - `created_at` string, date-time: When rooms.aero started tracking the hotel. RFC 3339 timestamp.
      - `updated_at` string, date-time: When the hotel record last changed. RFC 3339 timestamp.
    - `lowest_award_standard` integer: Cheapest standard room award, in points. 0 when none.
    - `lowest_award_suite` integer: Cheapest suite award, in points. 0 when none.
    - `lowest_cash_standard` integer: Cheapest standard room cash rate, in the minor unit of currency_code. 0 when none.
    - `lowest_cash_suite` integer: Cheapest suite cash rate. 0 when none.
    - `currency_code` string: ISO 4217 code for the cash rates.
    - `standard_date` string: Check-in date (YYYY-MM-DD) of the cheapest standard rate. Empty when none.
    - `standard_nights` integer: Stay length of the cheapest standard rate.
    - `suite_date` string: Check-in date of the cheapest suite rate. Empty when none.
    - `suite_nights` integer: Stay length of the cheapest suite rate.
    - `cpp` number: The better cents-per-point of the two room classes, in US cents.
    - `last_checked_at` string, date-time, nullable: Most recent retrieval among the hotel's matching dates. RFC 3339 timestamp.
  - `count` integer: Number of items in this response.
  - `has_more` boolean: Whether another page exists.
  - `more_url` string: URL of the next page. Omitted on the last page.

## Other responses

- `400`: Invalid or missing parameter, unknown location, or too many hotels
- `401`: Missing, unknown or unsubscribed credentials: missing_partner_key, bad_partner_key, bad_partner_token, invalid_scope or user_subscription_expired
- `429`: Daily quota exhausted

---

[API](https://skmtc.dev/seats/apis/rooms-api.md) - [All operations](https://skmtc.dev/seats/apis/rooms-api/llms.txt) - [OpenAPI document](https://skmtc.dev/seats/apis/rooms-api/revisions/e164f8ea0b28?raw)