---
title: "Refresh Hotel"
method: POST
path: "/hotels/{id}/refresh"
---

# Refresh Hotel

`POST /hotels/{id}/refresh`

## Request

- Base URL: `https://rooms.aero/partnerapi`
- URL: `https://rooms.aero/partnerapi/hotels/{id}/refresh`
- Auth: API key in header `Partner-Authorization`

Requests a fresh check of a hotel's rates. New data typically appears within minutes; read it back with Get Availability afterwards. Each user may request one refresh every 24 hours, and the allowance is shared with the refresh button on the site.

## Path parameters

- `id` string, required

## Response `202`

Queued

- RefreshResponse
  - `hotel_id` string: The hotel that was queued.
  - `status` string: Always queued.
  - `message` string: Human-readable confirmation.

## Other responses

- `401`: Missing, unknown or unsubscribed credentials: missing_partner_key, bad_partner_key, bad_partner_token, invalid_scope or user_subscription_expired
- `404`: Unknown hotel
- `429`: Refresh allowance or 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)