booking.hotel.search
View connectorSearch guest stays with the current destination filter catalog
POST /v1/operations/booking.hotel.searchHeaders
Authorization: Bearer YOUR_CONNECTOR_TOKEN
x-connection-ref: YOUR_CONNECTION_REF
Content-Type: application/jsonUse your connector bearer token and guest connection_ref in x-connection-ref. First predict a destination and replace place_ref with an items[].place_ref from that response. Use future dates and filter_id values from the search catalog.
Inputs
| Parameter | Example type | Example value |
|---|---|---|
| place_ref | string | "00000000-0000-0000-0000-000000000000" |
| checkin | string | "2027-01-12" |
| checkout | string | "2027-01-14" |
| filters | array | ["class::5","facility::433","property_type::204"] |
| price_max | number | 900 |
Example input
{
"place_ref": "00000000-0000-0000-0000-000000000000",
"checkin": "2027-01-12",
"checkout": "2027-01-14",
"filters": [
"class::5",
"facility::433",
"property_type::204"
],
"price_max": 900
}Input schema
{
"$id": "https://useajar.com/schemas/booking/hotel-search.input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"adults": {
"default": 2,
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"checkin": {
"format": "date",
"type": "string"
},
"checkout": {
"format": "date",
"type": "string"
},
"children_ages": {
"items": {
"maximum": 17,
"minimum": 0,
"type": "integer"
},
"maxItems": 10,
"type": "array"
},
"currency": {
"enum": [
"GBP",
"EUR",
"USD"
]
},
"distance_m": {
"description": "Maximum distance from a predicted landmark or airport; defaults to 1000 when near_place_ref is supplied.",
"enum": [
250,
500,
1000,
3000
]
},
"filters": {
"items": {
"maxLength": 200,
"type": "string"
},
"maxItems": 50,
"type": "array",
"uniqueItems": true
},
"min_bathrooms": {
"maximum": 12,
"minimum": 0,
"type": "integer"
},
"min_bedrooms": {
"maximum": 5,
"minimum": 0,
"type": "integer"
},
"min_beds": {
"maximum": 5,
"minimum": 0,
"type": "integer"
},
"near_place_ref": {
"format": "uuid",
"type": "string"
},
"place_ref": {
"format": "uuid",
"type": "string"
},
"price_max": {
"minimum": 0,
"type": "integer"
},
"price_min": {
"minimum": 0,
"type": "integer"
},
"rooms": {
"default": 1,
"maximum": 10,
"minimum": 1,
"type": "integer"
}
},
"required": [
"place_ref",
"checkin",
"checkout"
],
"title": "Booking.com hotel-search input",
"type": "object"
}