Quote

Search up to 3,000 hotel codes or one destination for available rooms. Each combination in the response carries the combinationKey you send to Confirm.

POST/booking/accommodations/quote

tripType and filter are optionalConfirmed

Leave them out and the search runs as tripType: "ONLY_HOTEL" with the default filter. A Quote without them returns the same hotels as one that sends them. Tested Send tripType anyway when you can, so the request says what it is.

Request

Headers

auth-tokenstringrequired

The token for the whole flow, through Book. Check it has at least 60 minutes left.

Accept-EncodingstringrequiredDocs

gzip

Content-Typestringrequired

application/json

Body

checkIndaterequiredTested

yyyy-MM-dd, for example 2026-11-10. Missing: 400, quote.request.quote.stay.checkIn: must not be null.

checkOutdaterequiredTested

yyyy-MM-dd. At most 30 nights after checkIn. A longer stay gets 400, You cannot select more than 30 nights. Suppliers may add their own restrictions. Confirmed

distributionsobject[]requiredTested

One entry per room, 1 to 4 rooms. Outside that range: 400.

Child attributes

personsobject[]requiredTested

The people in the room: 1 to 6, children included, or 400. At least one adult and at most 5 children, per the docs; those two rules are not checked up front.

persons[].ageintegerrequiredDocs

Each guest's age at checkout. Children are 0-17. Prebook's requestedAge must equal it.

languageLanguage

Content language, for example EN, ES or AR. See Enums.

sourceMarketstring

ISO 3166-1 alpha-2 code of the customer's market or nationality, for example AE. Drives market-specific rates.

tripTypeTripTypeConfirmed

Send ONLY_HOTEL, the default. An unknown value gets 400 listing the accepted ones. Tested

timeoutinteger, ms, or nullTested

How long to wait for suppliers. At least 3000, or 400. Send null or leave it out to use your account's default. Set your HTTP timeout well above it.

accommodationsstring[]Tested

Up to 3,000 unique hotel codes (3,001 gets 400) within about 200 km of each other. Send this or destinationId, never both. Sending both is not rejected up front.

destinationIdstring

A destination code such as MAD, from Destinations. Send this or accommodations.

filterobjectConfirmed

Optional, and so is every field inside it. Leave it out to get the defaults below.

Child attributes

bestCombinationsbooleanDocs

Default true: only the best combinations. false returns all of them.

maxCombinationsinteger, 1 to 60Tested

Combinations per hotel. 61 gets 400. Default 1 when bestCombinations is true, 60 when it is false.

includeOnRequestOptionsbooleanDocs

Default true. false removes on-request combinations.

Response

200 OK

auditDataAuditResponseVO

traceId (one per token, the same on every call of the flow: log it), availabilityId (ties the calls of one flow together) and authToken (redact it before logging).

totalinteger

Number of hotels returned.

accommodations[]object[]

One entry per hotel with availability.

Child attributes

codestring

Hotel code. Use it as {accommodationId} in the next steps.

quoteSingleNeededbooleanDocs

true: more combinations exist than were returned. The ones you have are still bookable. More below.

combinations[]object[]

The room combinations. Fields below.

accommodations[].combinations[]object[]

One bookable offer: rooms, meal plan, price and policies.

Child attributes

combinationKeystring

Send it to Confirm. Opaque, any length, server-side only.

rooms[]object[]

One entry per requested room: description and groupingRoomType.

mealPlanMealPlanVO

id (a code such as RO), type (such as ROOM_ONLY), description and providerDescription.

onRequestboolean

true: no confirmed quota. The supplier has to accept the booking.

priceMoneyVO

amount and currency. Always the microsite currency. Informational until Confirm.

providerstringDocs

The supplier, for example Expedia.

cancellationPolicies[]CancellationPolicyVO[]

Penalty steps: from date on, cancelling costs amount. Informational until Confirm.

currentCancellationTypeobject

Summary: type (REFUNDABLE, PARTIALLY_REFUNDABLE, NON_REFUNDABLE or UNKNOWN) and deadline.

remarks[]string[]

Supplier remarks. Informational until Confirm.

recommendedSellingPriceMoneyVO

Only when the microsite or supplier provides one. Don't depend on it.

priceBreakdownobject

agencyFee, and rsp with applied and price.

offerobject

strikethroughPrice, only when the supplier sends an offer.

providerTraces[]ProviderTraceVO[]

Per supplier: provider, providerDescription, start, end, processTime, error and quoteResults. Check it when results are empty.

Quote by destination

curl -s --compressed -X POST \
  "$NAVA_BASE_URL/booking/accommodations/quote" \
  -H "auth-token: $TOKEN" \
  -H "Accept-Encoding: gzip" \
  -H "Content-Type: application/json" \
  --max-time 40 \
  -d '{
    "checkIn": "2026-11-10",
    "checkOut": "2026-11-14",
    "distributions": [{ "persons": [{ "age": 30 }, { "age": 30 }] }],
    "language": "EN",
    "sourceMarket": "AE",
    "tripType": "ONLY_HOTEL",
    "timeout": 8000,
    "filter": { "bestCombinations": true, "maxCombinations": 4, "includeOnRequestOptions": false },
    "destinationId": "MAD"
  }'

Response 200 (trimmed)

{
  "auditData": {
    "timestamp": "2026-09-29 07:58:28",
    "processTime": 18099,
    "authToken": "[REDACTED]",
    "traceId": "D4AE54C6-FAED-40D8-9B9F-1B8555459610",
    "availabilityId": 188,
    "server": "…"
  },
  "total": 2,
  "accommodations": [
    {
      "code": "157117",
      "quoteSingleNeeded": true,
      "combinations": [
        {
          "combinationKey": "157117||14449||RO||d7oNg",
          "rooms": [{ "description": "Studio (2 adults)" }],
          "mealPlan": { "id": "RO", "type": "ROOM_ONLY", "description": "ROOM ONLY" },
          "onRequest": false,
          "price": { "amount": 808.04, "currency": "EUR" },
          "provider": "Expedia",
          "cancellationPolicies": [
            { "date": "2026-09-29", "amount": { "amount": 0.0, "currency": "EUR" } },
            { "date": "2026-11-07", "amount": { "amount": 444.46, "currency": "EUR" } },
            { "date": "2026-11-10", "amount": { "amount": 808.04, "currency": "EUR" } }
          ],
          "remarks": [],
          "currentCancellationType": { "deadline": "2026-11-07", "type": "REFUNDABLE" }
        }
      ]
    }
  ]
}

Hotel codes or a destination

Send exactly one of accommodations and destinationId. Spec

	`accommodations`	`destinationId`
Sends	Up to 3,000 hotel codes	One destination code, such as `MAD`
Codes come from	Your catalogue: Accommodations	Destinations
Good for	Map, radius and shortlist searches	A destination search box
Rules	Unique codes, within about 200 km of each other

One call with 3,000 codes beats many small calls. Docs
Deduplicate the list first. The spec requires unique codes. Spec
A hotel that has left the catalogue returns nothing. Refresh your catalogue weekly. Docs

Best combinations

With the defaults (bestCombinations: true, maxCombinations: 1) you get one combination per hotel. The docs define "best" as the best combination for each available meal plan and whether it is refundable or non-refundable. Docs

The docs' worked example: a hotel has six combinations.

Meal plan	Price	Refundability
RO	100	Non-refundable (NR)
RO	110	Non-refundable (NR)
RO	150	Refundable (R)
AI	200	Partially refundable (PR)
AI	210	Non-refundable (NR)
AI	220	Refundable (R)

`maxCombinations`	Returned
4	RO 100 NR, RO 150 R, AI 200 PR, AI 220 R
2	RO 100 NR, RO 150 R
1 (default)	RO 100 NR

Our reading of that example, derived from it and not stated in the docs: "best" keeps the cheapest combination per meal plan in two classes, fully refundable (R) and not fully refundable (NR and PR together). That is why AI 210 NR is dropped for the cheaper AI 200 PR, and RO 110 NR for RO 100 NR. The survivors are sorted by price and cut at maxCombinations. Unverified

To see everything, send bestCombinations: false (up to 60 per hotel) and call Quote single for hotels marked quoteSingleNeeded. Docs

`onRequest` and `quoteSingleNeeded`

onRequest: true means only on-request quota exists: the supplier has to accept the booking. With includeOnRequestOptions: false, on-request combinations are filtered out, so onRequest is always false. Docs
onRequest: false is not a promise. Book can still return RQ. Verified See Booking statuses.
quoteSingleNeeded: true does not mean "not bookable". A supplier returned a partial set: the combinations you have are bookable, and more exist. Call Quote single to see them all. Docs

`combinationKey`

Opaque. The format varies by supplier and step: a short string such as 157117||14449||RO||d7oNg, or a signed JWT that may also be deflated. Don't parse it.
Store it as unbounded text. No fixed-length column.
Never persist it long term. It changes on every response and expires 40 minutes after the Quote response. Docs
Keep it on your server. The sample keys in the docs decode to readable JWTs that hold the net price, the commission and the supplier's purchase token. Give your front end an id of your own and map it to the key on the server. Docs

Timeouts

timeout caps how long the API waits for suppliers. The minimum is 3000 ms. Spec
The whole call can run a few seconds past it. The docs' own example took 18 seconds. Docs
Set your HTTP timeout to at least timeout plus 30 seconds, and show progress in your UI.

Prices and policies

Prices, cancellation policies and remarks here are informational. Only Confirm guarantees them.
price.currency is always the microsite currency. You cannot request another one, so convert for display yourself. Docs
A rate is valid for about one hour. Never cache quote prices in your catalogue. Docs
mealPlan.type collapses mixed plans to the nearest type: "1 bed and breakfast + 1 half board" becomes HALF_BOARD. Show description to guests. Docs
cancellationPolicies[] is cumulative. In the sample response, cancelling is free until 6 November, costs 444.46 EUR from 7 November and the full price from 10 November. See Cancellations.

Limits

Limit	Value
Rooms per booking	1 to 4	Tested
People per room	1 to 6, children included	Tested
Adults and children per room	At least 1 adult, at most 5 children	Docs
People per booking	15, at most 14 children	Docs
Child ages	0-17	Docs
Length of stay	30 nights (`checkOut` minus `checkIn`)	Tested
Hotel codes per call	3,000	Tested
`timeout`	At least 3000 ms, or `null` for your account's default	Tested
`maxCombinations`	1 to 60	Tested

The limits marked Tested are rejected with 400 as soon as the request arrives. The others are not checked up front, so enforce them in your form.

All limits: Limits.

Gotchas

Send each guest's age at checkout, not today's age. A child who turns 6 during the stay is 6. Otherwise Prebook fails with "Child age different from availability". Docs
Use future dates. The docs samples use past dates, which return nothing.
Count nights, not days: 1 to 31 March is 30 nights and is accepted; 1 March to 1 April is 31 nights and gets 400. Tested Suppliers can add their own restrictions on top. Confirmed
Empty results: read providerTraces[] for supplier errors, then check Provider configurations to see which suppliers your microsite has.
Parse enums leniently. New values appear, so route unknown ones to review instead of crashing. Verified
Never replace one Quote with many Quote single calls in parallel. That is unsupported. Docs

RequestCopy Anchor Link

ResponseCopy Anchor Link

Hotel codes or a destinationCopy Anchor Link

Best combinationsCopy Anchor Link

onRequest and quoteSingleNeededCopy Anchor Link

combinationKeyCopy Anchor Link

TimeoutsCopy Anchor Link

Prices and policiesCopy Anchor Link

LimitsCopy Anchor Link

GotchasCopy Anchor Link

RelatedCopy Anchor Link

Request

Response

Hotel codes or a destination

Best combinations

`onRequest` and `quoteSingleNeeded`

`combinationKey`

Timeouts

Prices and policies

Limits

Gotchas

Related