Get Alerts

Lists the alerts on your rooms.aero account, newest first. Alerts are created and deleted at https://rooms.aero/alerts; the API is read-only. Expired one-off alerts are left out unless include_expired is set. Requires a Pro user's API key.

get/alerts

Request

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

Query parameters

include_expiredboolean

Include one-off alerts that have already fired.

skipinteger

How many results to skip. Pagination is skip/take: request the next page with skip = skip + take, or follow more_url.

takeinteger

Maximum results to return. Must be between 1 and 500.

Response

200

countinteger

Number of items in this response.

has_moreboolean

Whether another page exists.

more_urlstring

URL of the next page. Omitted on the last page.

Example response

{
  "data": [
    {
      "hotel": {
        "id": "2PPrELk9WcfJaNREWEPXypvhXAD",
        "source": "hyatt",
        "program": "World of Hyatt",
        "name": "Park Hyatt Tokyo",
        "brand": "park",
        "award_category": "7",
        "address": "3-7-1-2 Nishi Shinjuku, Shinjuku-Ku",
        "city": "Tokyo",
        "country": "Japan",
        "latitude": 35.6852,
        "longitude": 139.6891,
        "image_url": "https://assets.hyatt.com/content/dam/hyatt/hyattdam/images/2018/03/02/1141/Park-Hyatt-Tokyo-P011-Exterior.jpg",
        "internal_id": "tyoph",
        "open": true,
        "url": "https://rooms.aero/hyatt/hotel/2PPrELk9WcfJaNREWEPXypvhXAD",
        "lowest_award": 30000,
        "standard_award_availability_percent": 41,
        "standard_award_availability_window_days": 90
      },
      "date_type": "fixed_date",
      "arrival_date_start": "2026-11-21",
      "arrival_date_end": "2026-11-21",
      "num_nights": 2,
      "alert_mode": "one_off",
      "channel": "email",
      "max_points": 40000
    }
  ],
  "count": 2
}

Changes

No recorded changes to this operation across all 1 revision of this API.