Destinations

List the destinations and countries your microsite sells, and read one destination in detail. A destination code is what Quote expects in destinationId.

Destinations are the search entry points for Quote. List them once per language, offer them in your search box, and send the chosen code as Quote's destinationId.

destination code = Quote destinationIdDocs

destination[].code, for example MAD, is exactly what Quote expects in destinationId. In your test account, use your test microsite id.

List destinations

GET/destination/{micrositeId}

Request

Headers

auth-tokenstringrequiredDocs

Any valid token. Static content doesn't need the booking-flow token.

Accept-EncodingstringrequiredDocs

gzip

Path

micrositeIdstringrequired

Your microsite id, from your credentials. In your test account, your test microsite id.

Query

countryCodestring

Country code, for example ES.

langLanguage

Language of the names, for example EN.

iatastring

Airport code, for example MAD. Use it for an airport-based search.

All query parameters are optional. Spec

Response

200 OK

destination[]object[]Spec

One entry per destination.

Child attributes

codestring

Destination code. Send it as destinationId in Quote.

namestring

Destination name.

geolocationGeolocationVO

latitude and longitude.

country

Country of the destination.

provincePostalPrefix

Province postal prefix.

active

Active flag.

images[]

Destination images.

iata

IATA code.

auditDataAuditResponseVO

Includes traceId (one per token: log it) and authToken (redact it before logging).

Request

curl -s --compressed "$NAVA_BASE_URL/destination/$NAVA_MICROSITE_ID?countryCode=ES&lang=EN" \
  -H "auth-token: $TOKEN" \
  -H "Accept-Encoding: gzip"

Response 200 (trimmed)

{
  "auditData": {
    "authToken": "[REDACTED]",
    "traceId": "…"
  },
  "destination": [
    {
      "code": "MAD",
      "name": "Madrid",
      "geolocation": { "latitude": 40.4168, "longitude": -3.7038 },
      "iata": "MAD"
    }
  ]
}

One destination

GET/destination/{micrositeId}/{destinationId}

Returns one destination with the same fields as the list, plus description.

Request

Headers

auth-tokenstringrequired

Any valid token.

Accept-EncodingstringrequiredDocs

gzip

Path

micrositeIdstringrequired

Your microsite id.

destinationIdstringrequired

A destination code from the list, for example MAD.

Query

langLanguage

Language of the name and description.

Response

A DestinationVO: the fields of a list entry, plus description. Spec

Request

curl -s --compressed "$NAVA_BASE_URL/destination/$NAVA_MICROSITE_ID/MAD?lang=EN" \
  -H "auth-token: $TOKEN" \
  -H "Accept-Encoding: gzip"

Response 200 (trimmed)

{
  "code": "MAD",
  "name": "Madrid",
  "geolocation": { "latitude": 40.4168, "longitude": -3.7038 },
  "iata": "MAD",
  "description": "…"
}

Countries

GET/destination/countries/{micrositeId}

Lists the countries for your microsite, for example to build a country filter.

Request

Headers

auth-tokenstringrequired

Any valid token.

Accept-EncodingstringrequiredDocs

gzip

Path

micrositeIdstringrequired

Your microsite id.

Query

langLanguage

Language of the country names.

Response

200 OK

country[]object[]Spec

One entry per country.

Child attributes

id

Country id.

namestring

Country name.

auditDataAuditResponseVO

Log traceId (one per token), redact authToken.

Request

curl -s --compressed "$NAVA_BASE_URL/destination/countries/$NAVA_MICROSITE_ID?lang=EN" \
  -H "auth-token: $TOKEN" \
  -H "Accept-Encoding: gzip"

Response 200 (trimmed)

{
  "auditData": {
    "authToken": "[REDACTED]",
    "traceId": "…"
  },
  "country": [
    { "id": "…", "name": "Spain" }
  ]
}

Search entry points

The guest starts from	Do this
A destination	List destinations, then Quote with `destinationId`.
An airport	List destinations with `iata`, for example `?iata=MAD`, then Quote with `destinationId`.
A map or radius	Filter your local catalogue by `geolocation`, then Quote with up to 3,000 hotel codes that lie within about 200 km of each other. Docs
One hotel	Quote single with the hotel code.

Gotchas

Destinations belong to the microsite. Use the micrositeId from your own credentials.
If a destination returns no hotels in Quote, check which suppliers your microsite has in Provider configurations, and the per-supplier errors in Quote's providerTraces[].
Searches need future dates. The docs samples use past dates, and a search for past dates returns nothing.

List destinationsCopy Anchor Link

RequestCopy Anchor Link

ResponseCopy Anchor Link

One destinationCopy Anchor Link

RequestCopy Anchor Link

ResponseCopy Anchor Link

CountriesCopy Anchor Link

RequestCopy Anchor Link

ResponseCopy Anchor Link

Search entry pointsCopy Anchor Link

GotchasCopy Anchor Link

RelatedCopy Anchor Link

List destinations

Request

Response

One destination

Request

Response

Countries

Request

Response

Search entry points

Gotchas

Related