Overview
Inventory
Section titled “Inventory”Look up live prices for a property you already know — the paid Partner Inventory API.
Search finds properties and returns each one’s best offer. Inventory is the next step: given a property, return EVERY priced offer for the requested dates and occupancy, plus a rate calendar for planning across a date range.
These endpoints return PRICES, not property content. Names, descriptions, galleries, addresses, amenities
and policies come from the Content service — call it once per property, cache the answer, and refresh when
last_update changes. That keeps these responses small and means property content has exactly one source
of truth.
That split runs through the transactional inventory too. Ask for INVENTORY_SCOPE_SPA and you get the
spa’s PRICED ROWS keyed by inventory_id; the spa’s name, photographs and opening hours are the same
inventory_id in Content. Nothing is returned twice, and the half that changes by the minute is not
dragging the half that changes by the month across the wire on every call.
Every call needs an authenticated token with INVENTORY:READ on the account you name in the
managing-entity-id metadata header, and is billed in hotel-day units.
Prices are live and are not cached. Treat a result as valid for the length of a user’s session.