1. Search offers (Rates search)
This GraphQL query allows developers to retrieve detailed rate information for hotels, supporting multi-room bookings. By making a request with the required parameters, you receive an array of offers, each containing comprehensive rate details.
This query is essential for providing users with detailed booking options, including pricing and room specifications.
Request body
{
liteapi {
search(
criteria: {
checkIn: "2025-07-01"
checkOut: "2025-07-02"
occupancies: [{ paxes: [{ age: 30 }, { age: 26 }] }]
hotels: ["581234"]
currency: "USD"
nationality: "US"
maxRatesPerHotel: 1
}
settings: { client: "MyCompanyName", context: "1", timeout: 10000 }
) {
errors {
description
}
warnings {
description
}
options {
id
accessCode
supplierCode
hotelCode
hotelName
boardCode
paymentType
status
rateRules
remarks
occupancies {
id
paxes {
age
}
}
rooms {
occupancyRefId
code
description
refundable
roomPrice {
ratePlans
price {
currency
binding
net
gross
minimumSellingPrice
exchange {
currency
rate
}
markups {
type
value
}
}
breakdown {
start
end
price {
currency
binding
net
gross
minimumSellingPrice
exchange {
currency
rate
}
markups {
type
value
}
}
}
}
ratePlans {
start
end
code
name
}
}
price {
currency
binding
net
gross
minimumSellingPrice
exchange {
currency
rate
}
markups {
type
value
}
}
supplements {
description
price {
currency
binding
net
gross
minimumSellingPrice
exchange {
currency
rate
}
markups {
type
value
}
}
}
cancelPolicy {
refundable
cancelPenalties {
deadline
isCalculatedDeadline
penaltyType
currency
value
}
}
}
}
}
}
Sample response
{
"data": {
"liteapi": {
"search": {
"errors": [],
"warnings": [],
"options": [
{
"id": "GE5ESNKNKZKVEQ2OJJLEMRSRKIZE4R2O",
"accessCode": "2",
"supplierCode": "NUI2",
"hotelCode": "581234",
"hotelName": "",
"boardCode": "BI",
"paymentType": "MERCHANT",
"status": "OK",
"rateRules": null,
"remarks": "<ul><li>Free breakfast</li><li>Free self parking</li></ul>",
"occupancies": [
{
"id": 1,
"paxes": [
{
"age": 30
},
{
"age": 26
}
]
}
],
"rooms": [
{
"occupancyRefId": 0,
"code": "I5MVURCNJVFFQR2NGNCFGTSSKRDUSWKEJVHEEV2J",
"description": "Basic Double Room",
"refundable": true,
"roomPrice": {
"ratePlans": null,
"price": {
"currency": "USD",
"binding": false,
"net": 55.97,
"gross": null,
"minimumSellingPrice": null,
"exchange": {
"currency": "USD",
"rate": 1
},
"markups": null
},
"breakdown": [
{
"start": "2025-07-01",
"end": "2025-07-02",
"price": {
"currency": "USD",
"binding": false,
"net": 55.97,
"gross": null,
"minimumSellingPrice": null,
"exchange": {
"currency": "USD",
"rate": 1
},
"markups": null
}
}
]
},
"ratePlans": null
}
],
"price": {
"currency": "USD",
"binding": false,
"net": 55.97,
"gross": null,
"minimumSellingPrice": null,
"exchange": {
"currency": "USD",
"rate": 1
},
"markups": null
},
"supplements": null,
"cancelPolicy": {
"refundable": true,
"cancelPenalties": [
{
"deadline": "2025-06-29T20:59:00.000Z",
"isCalculatedDeadline": true,
"penaltyType": "IMPORTE",
"currency": "USD",
"value": 55.97
}
]
}
}
]
}
}
}
}
Updated 2 days ago