curl "$UNIFYSTAYS_BASE_URL/hotels/search/srch_a1b2c3d4e5f6g7h8/prices" \
-H "x-api-key: $UNIFYSTAYS_API_KEY" \
-H "language: en"
{
"success": true,
"message": "Price refresh status fetched",
"data": {
"search_id": "srch_a1b2c3d4e5f6g7h8",
"status": "REFRESHING",
"refresh_count": 8,
"total_hotels": 20,
"updated_prices": [],
"no_price_hotel_ids": []
}
}
Search & hotels
Get Search Price Updates
Poll a search session for fresh supplier prices and merge them into a visible result list.
GET
/
hotels
/
search
/
{searchId}
/
prices
curl "$UNIFYSTAYS_BASE_URL/hotels/search/srch_a1b2c3d4e5f6g7h8/prices" \
-H "x-api-key: $UNIFYSTAYS_API_KEY" \
-H "language: en"
{
"success": true,
"message": "Price refresh status fetched",
"data": {
"search_id": "srch_a1b2c3d4e5f6g7h8",
"status": "REFRESHING",
"refresh_count": 8,
"total_hotels": 20,
"updated_prices": [],
"no_price_hotel_ids": []
}
}
After an
To prioritize hotel cards currently on screen, pass up to 50 comma-separated
hotel IDs in
instant hotel search, call this endpoint every two seconds while the
customer is viewing the result page. It returns the hotel prices that have
become fresh since the search response.
Request Example
curl "$UNIFYSTAYS_BASE_URL/hotels/search/srch_a1b2c3d4e5f6g7h8/prices" \
-H "x-api-key: $UNIFYSTAYS_API_KEY" \
-H "language: en"
refresh_ids:
curl "$UNIFYSTAYS_BASE_URL/hotels/search/srch_a1b2c3d4e5f6g7h8/prices?refresh_ids=123456,789012" \
-H "x-api-key: $UNIFYSTAYS_API_KEY" \
-H "language: en"
Update the Result List
1
Keep the search ID
Save
data.search_id from the original hotel search response.2
Poll while results are visible
Poll every two seconds only while the customer is actively viewing the
search results.
3
Merge updates
Replace the matching hotel card data using each
updated_prices item and
its hotel_id, then reapply the current sort order.4
Stop the loop
Stop polling when
data.status is COMPLETE or EXPIRED, or when the
customer leaves the result page.Response Example
{
"success": true,
"message": "Price refresh status fetched",
"data": {
"search_id": "srch_a1b2c3d4e5f6g7h8",
"status": "REFRESHING",
"refresh_count": 8,
"total_hotels": 20,
"updated_prices": [],
"no_price_hotel_ids": []
}
}
no_price_hotel_ids identifies hotels whose live supplier requests returned no
price for the stay. Your UI can badge, deprioritize, or remove them according
to the product experience.
The OpenAPI section below contains all status values, request parameters, and
the precise update payload.Authorizations
Environment-specific API key created in the Unifystays portal
Headers
Hotel API contract version. Missing defaults to v1.
Available options:
1 Path Parameters
Example:
"srch_a1b2c3d4e5f6g7h8"
Query Parameters
Comma-separated hotel ids to refresh on demand (max 50).
Example:
"15419351,15312010"
Response
Cumulative prices from all suppliers received so far. The response identifies every quote by hotel_id, supplier_code, and supplier_name; the API consumer chooses which supplier price to show.