Get Search Price Updates

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": []
  }
}

GET

hotels

{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 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"

To prioritize hotel cards currently on screen, pass up to 50 comma-separated hotel IDs in 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

Keep the search ID

Save data.search_id from the original hotel search response.

Poll while results are visible

Poll every two seconds only while the customer is actively viewing the search results.

Merge updates

Replace the matching hotel card data using each updated_prices item and its hotel_id, then reapply the current sort order.

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

x-api-key

string

header

required

Environment-specific API key created in the Unifystays portal

Headers

Path Parameters

searchId

string

required

Example:

"srch_a1b2c3d4e5f6g7h8"

Query Parameters

refresh_ids

string

Comma-separated hotel ids to refresh on demand (max 50).

Example:

"15419351,15312010"

Response

success

boolean

required

Example:

true

message

string

required

Example:

"Price refresh status fetched"

data

object

required

Show child attributes

⌘I

Overview

Destination & master data

Search & hotels

Bookings

Request Example

Update the Result List

Response Example

Authorizations

Headers

Path Parameters

Query Parameters

Response

​Request Example

​Update the Result List

​Response Example

Authorizations

Headers

Path Parameters

Query Parameters

Response

Request Example

Update the Result List

Response Example