Hotels API

Provider configurations

List the supplier connections configured on your microsite. Check it first when a destination or a hotel search returns nothing.

GET/providers/configurations/{micrositeId}

What you can search and book depends on the suppliers connected to your microsite, not on the API itself. This endpoint lists those connections.

Check this when a search comes back empty

When a destination returns nothing, check which suppliers your microsite has here, then read Quote's providerTraces[] for per-supplier timing and errors.

Not every API user can call this endpoint. One enabled only for the hotel booking flow gets 401 with User … not allowed to access here; ask your Nava account manager if you need it. Tested

Request

Headers

auth-tokenstringrequired
Any valid token.
Accept-EncodingstringrequiredDocs
gzip

Path

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

Response

The response is a bare JSON array of ProviderConfigurationVO. Tested It lists every connection on the microsite, not only hotel suppliers: transfers, car rental, tickets and trains appear too.

200 OK

[]ProviderConfigurationVO[]Spec

One entry per supplier connection.

Child attributes
idinteger
Id of the connection.
descriptionstring
Description of the connection.
providerstring
The supplier, as an upper-case code such as BOOKING_COM. Parse it as a plain string: new codes appear.

Because the body is an array, there is no auditData. There is no Travelc-Trace-Id header either. Tested For support, keep the full request and response in your logs, with the token redacted. Confirmed Log the x-request-id response header too.

When a search returns nothing

Work through these checks in order:

Dates. Searches need future dates. Sample dates copied from old docs are in the past, and a search for past dates returns nothing.

Suppliers. Call this endpoint to see which supplier connections your microsite has. If you expected one that isn't listed, ask your Nava account manager.

Per-supplier errors. Read providerTraces[] in the Quote response. Each entry has provider, providerDescription, its timing (start, end, processTime), error and quoteResults.

Stale hotel codes. A hotel code that has left the accommodation list returns nothing. This happens when its supplier is disconnected.

  • Booked hotel services read through getBookings carry provider, providerDescription and providerConfigurationId, which name the connection that sold them. providerConfigurationId probably matches an id from this list. Unverified
  • Which hotels appear in the accommodation list also depends on these connections, so two microsites can see different hotel sets.

Destinations

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

Shared schemas

Objects that appear across many endpoints, such as auditData, money, meal plans, cancellation policies, pagination, rooms and passengers. Field names, types and validation patterns come from the OpenAPI spec.