Stream the offers of one property as suppliers answer. Takes the body of POST /v1/stays/fares (searchSolutionId + propertyId, or a direct property block) with an optional currency, and accepts a bearer token or a guest session token. Each offer is one combination of room, board and cancellation terms with one price; no supplier is named. The route answers 404 while the feature is off. A malformed searchSolutionId, an unknown or malformed propertyId, or an expired search whose property is no longer known returns 410 OFFER_EXPIRED. A repeat request for the same property replays the newest snapshot without new supplier calls.
Frame vocabulary (event: names on this stream):
offers— the whole offer set;revisionrises by 1 per frame. An offer'sid,totalandfreeCancellationUntilnever change within a set; later frames add offers.done— terminal frame,data: {complete, reason}withreasonone ofall_suppliers,deadline,no_rates. An empty result isoffers: []followed bydonewithno_rates.error— terminal frame on failure;data: {"code": ..., "message": ...}withPROVIDER_ERRORorMAX_NIGHTS_EXCEEDEDas on the fares stream, orINTERNAL_ERRORwhen an offer could not be stored.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
401Unauthenticated
404Stay offers are not enabled
410Malformed search, unknown property, or expired search with an unknown property; refresh search
503Provider or offer store unavailable