Overview

Enterprise-only endpoint that prices every length of stay (LOS) × occupancy combination for a single check-in across up to 200 hotels. LOS is the number of nights between check-in and check-out. Returns an NDJSON stream (one hotel object per line) so you can process results as they arrive.

When to Use

• Build a LOS matrix for a check-in date across many hotels without calling /hotels/rates repeatedly
• Compare occupancy options (e.g. 2 adults vs 2 adults + child) for the same stay window

What You Get

• One NDJSON line per hotel with every LOS × occupancy cell exactly once
• Trimmed rates — cheapest RFN (free-cancel until checkin−N days, default N=5) and cheapest NRFN per mappedRoomId × feed
• Prebookable offerId values — same booking flow as /hotels/rates
• Per-cell status — ok, no_availability, or error with a machine-readable code

Key Features

• Inclusive LOS range via lengthsOfStay.min / lengthsOfStay.max (max 28 nights)
• Up to 8 occupancy options priced independently (not multi-room in one booking)
• Multi-feed support with the same feed / feeds rules as /hotels/rates
• Configurable trim depth via maxRatesPerHotel (default 10 rates requested per cell before RFN/NRFN trim)
• Refundable deadline control via refundableDeadlineDaysBeforeCheckin (default 5; set 0 to disable)

Quick Start

Required fields: hotelIds, checkin, lengthsOfStay, occupancies, currency, guestNationality

Tip: Start with a small LOS range (e.g. min=1, max=2) and one occupancy while integrating. Enable roomMapping when you need mappedRoomId for room content.

Rate limit: Each call costs losCount × occupancyCount × feedCount against your API key quota. Check the X-RateLimit-Cost response header.

{
  "hotelIds": [
    "lp1897"
  ],
  "checkin": "2026-11-20",
  "lengthsOfStay": {
    "min": 1,
    "max": 2
  },
  "occupancies": [
    {
      "adults": 2,
      "children": [
        5
      ]
    }
  ],
  "currency": "USD",
  "guestNationality": "US",
  "roomMapping": true,
  "timeout": 30,
  "maxRatesPerHotel": 10,
  "refundableDeadlineDaysBeforeCheckin": 5
}