Sign in
hotel-search

Create Session

Create a hotel search session.

post/hotel-search/sessions/

Request body

check_instring date required
check_outstring date required

Example request

{
  "guests": {
    "rooms": [
      {
        "adults": 2,
        "children": [
          {
            "age": 5
          }
        ]
      }
    ]
  },
  "filters": {
    "amenities": [
      "wifi",
      "pool"
    ],
    "max_price_per_night": {
      "amount": 30000,
      "currency": "USD"
    },
    "max_star_rating": 4,
    "min_price_per_night": {
      "amount": 10000,
      "currency": "USD"
    },
    "min_review_score": 7.5,
    "min_star_rating": 3,
    "refundable_only": false
  }
}

Response

Successful Response

session_idstring uuid required
check_instring date required
check_outstring date required
nightsinteger required
criteria_hashstring nullable
created_atstring date-time required
expires_atstring date-time required
last_activity_atstring date-time nullable

Example response

{
  "guests": {
    "rooms": [
      {
        "adults": 2,
        "children": [
          {
            "age": 5
          }
        ]
      }
    ]
  },
  "filters": {
    "amenities": [
      "wifi",
      "pool"
    ],
    "max_price_per_night": {
      "amount": 30000,
      "currency": "USD"
    },
    "max_star_rating": 4,
    "min_price_per_night": {
      "amount": 10000,
      "currency": "USD"
    },
    "min_review_score": 7.5,
    "min_star_rating": 3,
    "refundable_only": false
  },
  "criteria": {
    "guests": {
      "rooms": [
        {
          "adults": 2,
          "children": [
            {
              "age": 5
            }
          ]
        }
      ]
    }
  },
  "initial_results": {
    "guests": {
      "rooms": [
        {
          "adults": 2,
          "children": [
            {
              "age": 5
            }
          ]
        }
      ]
    },
    "filters": {
      "amenities": [
        "wifi",
        "pool"
      ],
      "max_price_per_night": {
        "amount": 30000,
        "currency": "USD"
      },
      "max_star_rating": 4,
      "min_price_per_night": {
        "amount": 10000,
        "currency": "USD"
      },
      "min_review_score": 7.5,
      "min_star_rating": 3,
      "refundable_only": false
    },
    "criteria": {
      "guests": {
        "rooms": [
          {
            "adults": 2,
            "children": [
              {
                "age": 5
              }
            ]
          }
        ]
      }
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.