Quickstart

This guide takes you from portal setup to your first hotel search. After this, continue through the booking flow guides.

1. Configure the Sandbox

Add the credentials for a hotel supplier.
Enable the supplier.
Create a sandbox API key.

Supplier credentials and API keys are managed directly in the portal.

2. Set Your API Key

export UNIFYSTAYS_API_KEY="your_sandbox_api_key"
export UNIFYSTAYS_BASE_URL="https://api-sandbox.unifystays.com"

Use the production base URL and a production API key only when you are ready to send live traffic.

3. Find a Destination

curl "$UNIFYSTAYS_BASE_URL/destinations/autocomplete?q=dubai&types=place,city,hotel&limit=5" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en"

Use the returned type and matching ID in the search request: city_id for a city, hotel_id for a hotel, or place_id for a place. See Destination Autocomplete for complete fields, response details, and caching guidance.

4. Search Hotels

curl "$UNIFYSTAYS_BASE_URL/hotels/search" \
  -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en" \
  -d '{
    "destination": {
      "type": "city",
      "id": 101
    },
    "check_in": "2026-09-12",
    "check_out": "2026-09-15",
    "nationality": "IN",
    "rooms": [
      {
        "adults": 2,
        "child_ages": []
      }
    ],
    "limit": 20,
    "pricing_mode": "instant",
    "sort": "recommended"
  }'

The response includes hotel results and a search_id. When pricing_mode is instant, poll for live supplier prices.

curl "$UNIFYSTAYS_BASE_URL/hotels/search/srch_a1b2c3d4e5f6g7h8/prices" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en"

Merge data.updated_prices into your visible hotel list by hotel_id.

5. Continue to Rooms

Pick a hotel from the search response and request room options:

curl "$UNIFYSTAYS_BASE_URL/hotels/123456/rooms" \
  -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en" \
  -d '{
    "check_in": "2026-09-12",
    "check_out": "2026-09-15",
    "nationality": "IN",
    "rooms": [
      {
        "adults": 2,
        "child_ages": []
      }
    ]
  }'

Each bookable room option includes a booking_token. Use that token in the prebook step. Continue with the Hotel Booking Flow or open any endpoint in the API Reference.

Get started

Build your integration

Operate

1. Configure the Sandbox

2. Set Your API Key

3. Find a Destination

4. Search Hotels

5. Continue to Rooms

​1. Configure the Sandbox

​2. Set Your API Key

​3. Find a Destination

​4. Search Hotels

​5. Continue to Rooms

1. Configure the Sandbox

2. Set Your API Key

3. Find a Destination

4. Search Hotels

5. Continue to Rooms