Stream stay fares for a stay solution. Accepts either Mercury UUIDs from a prior POST /v1/stays/search stream (searchSolutionId + propertyId) or a direct property block from autocomplete (no prior search required). Accepts either an authenticated bearer token or a guest session token. Rates still load after the search has expired. A malformed searchSolutionId, an unknown or malformed propertyId, or an expired search whose property is no longer known returns 410 OFFER_EXPIRED; a property with no rates for the requested dates streams an empty result (event: done). When the requested stay exceeds the configured maximum nights, the stream terminates with event: error and code MAX_NIGHTS_EXCEEDED (message includes the allowed maximum). Other provider failures use PROVIDER_ERROR.
Frame vocabulary (event: names on this stream):
solution— one priced stay fare.done— terminal frame; the stream is exhausted (data: {}).error— terminal frame on failure;data: {"code": ..., "message": ...}.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Unauthenticated
Malformed search, unknown property, or expired search with an unknown property; refresh search
Provider unavailable