Get booking

Read a whole trip, every service type included, by microsite and booking reference. This is the call to make after a webhook, and the source of truth for back-office and accounting syncs.

GET/booking/getBookings/{micrositeId}/{bookingReference}

The webhook is a signal, this is the truthDocs

A booking webhook carries only micrositeId, bookingReference, type and timestamp. Call this endpoint with those two values to read what actually changed. The hotel is in hotelservice[].

Request

Headers

auth-tokenstringrequired

Any valid token. A long-running back-office process can keep one cached token.

Accept-EncodingstringrequiredDocs

gzip

Path

micrositeIdstringrequired

The microsite the booking was made on. See Which microsite to use.

bookingReferencestringrequired

Trip reference, for example TST-1464.

Query

langLanguage

Language for text fields, for example EN.

Response

BookedTripVO, the whole trip. Spec The fields that matter for hotels:

200 OK

bookingReferencestring

Trip reference. customBookingReference holds its number, zero-padded (00001464). Tested

agencyBookingReferencestringTested

Your order id: the externalReference you sent to Book.

statusServiceStatus

Booking-level status, derived from the service statuses.

tripTypeTripType

ONLY_HOTEL for a hotel booking. Parse unknown values leniently.

creationDatestring

Also lastUpdateDate, startDate, endDate, nightsCount.

adultCountinteger

Also childCount and infantCount.

contactPersonPersonVO

The booking's contact.

distribution[]DistributionVO[]

Passengers per room, as { id, person[] }. name is the first name and lastName the surname.

hotelservice[]BookedHotelServiceVO[]

One entry per booked hotel service. Full field guide in Reading bookings.

Child attributes

idstringTested

Service id, for example TST-1464-0: the accommodation.bookingReference from Book. Probably also the serviceId for Cancel service. Unverified

bookingReferencestringTested

The supplier's reference for the service (FAKE-… on a test supplier). The best stable identity for the hotel service. Per-accommodation endpoints accept it as well as id.

statusServiceStatus

Service-level status.

hotelIdstring

Hotel code. Also hotelName, providerHotelId.

startDatestring

Check-in. Also endDate and nights.

mealPlanstringSpec

A plain string here, not the MealPlanVO object of the booking flow.

room[]object[]

{ id, roomTypeDescription, pricebreakdown } per room.

cancelPolicy[]CancellationPolicyVO[]Verified

The service's cancellation steps. Dates in UTC.

pricebreakdownServicePriceBreakdownVO

Current amounts. originalpricebreakdown holds the amounts at booking time.

providerBookingReferencestring

The supplier's confirmation number, which the hotel recognises.

commentsToAccommodationstring

Plural here, singular (commentToAccommodation) in the booking flow.

cancelationDatestring

(sic) Set once cancelled, with providerCancellationDate and cancellationType.

confirmationErrorCausestring

Why it failed, for BOOK_ERROR or NOT_BOOKED.

manualServicesobjectVerified

Services added by an agent. Manually added hotels are in manualServices.hotel[], not in hotelservice[].

cancellationPolicies[]CancellationPolicyVO[]Verified

Booking-level policy. Dates in operator local time, as agents see them. Show these to people.

pricebreakdownPriceBreakdownVO

Booking totals. Each amount has a microsite and an operator leg.

originalBookingAgencystringVerified

A plain string with the agency name, not an object.

historical[]object[]

{ dateTime, message }: a readable audit trail of changes.

clientrequest[]ClientRequestVO[]

Conversations on the booking. See Client requests.

auditDataAuditResponseVO

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

Also returned: user, payment, notes, bookedNotes[], invoices[], salesChannel, language, sourceMarket, voucherUrl, pdfs[], and service arrays for other product types, which these docs don't cover.

Request

curl -s --compressed \
  "$NAVA_BASE_URL/booking/getBookings/$NAVA_MICROSITE_ID/TST-1464?lang=EN" \
  -H "auth-token: $TOKEN" \
  -H "Accept-Encoding: gzip"

Response 200 (trimmed)

{
  "auditData": {
    "authToken": "[REDACTED]",
    "traceId": "…"
  },
  "bookingReference": "TST-1464",
  "status": "BOOKED",
  "tripType": "ONLY_HOTEL",
  "nightsCount": 4,
  "adultCount": 2,
  "childCount": 0,
  "originalBookingAgency": "EXAMPLE TRAVEL",
  "distribution": [{
    "id": "TST-1464-0",
    "person": [
      { "id": "TST-1464-0-0", "name": "Ana", "lastName": "Ruiz", "requestedAge": 34 },
      { "id": "TST-1464-0-1", "name": "Luis", "lastName": "Ruiz", "requestedAge": 36 }
    ]
  }],
  "agencyBookingReference": "ORDER-8812",
  "hotelservice": [{
    "id": "TST-1464-0",
    "bookingReference": "FAKE-1775464987",
    "status": "BOOKED",
    "hotelId": "MASTER-1782232",
    "hotelName": "Cristine Bedfor Mahón",
    "nights": 4,
    "category": "S4",
    "mealPlan": "…",
    "providerBookingReference": "…",
    "pricebreakdown": {
      "totalPrice": {
        "microsite": { "amount": 134.05, "currency": "EUR" },
        "operator": { "amount": 134.05, "currency": "EUR" }
      }
    }
  }],
  "clientrequest": []
}

Which microsite to use

Look the booking up with the microsite it was made on first. On a 404, try your other microsites. Verified
A mismatched micrositeId in the path has resolved bookings in the past. Don't rely on it: that loophole is expected to close. Verified
If one booking can be reached from more than one of your microsites, map them all to one canonical microsite before you use (micrositeId, bookingReference) as a key. Otherwise the same booking becomes two records. Verified

Reading the hotel

The short version. The full field guide is in Reading bookings.

Two services at the same hotel and dates are not a duplicate. When an agent cancels and rebooks, hotelservice[] holds one CANCELED service at price 0 and one BOOKED service, with different service references. Never deduplicate by hotel and dates. Verified
The booking total can exceed the sum of the hotel services. Booking-level fees, taxes and non-hotel or manual services are included in the total on a meaningful share of bookings. Reconcile the difference explicitly. Verified
Supplier currencies appear in the cost legs. providerNetPrice and netProvider.microsite can be in the supplier's currency even when the guest paid in yours. For single-currency accounting, the .operator legs are a good choice. Verified
Values change after booking. A repricing updates pricebreakdown, and a cancelled service can drop to 0. Verified
Text fields can contain HTML. Treat remarks[] and service names as untrusted: strip markup before display. Verified

What is not here

A field called externalReference. Your order id comes back as agencyBookingReference. Tested Booking detail returns it under its own name.
A list of bookings. Use List bookings. The old listing variant of getBookings is deprecated.

Errors

Status	Meaning	What to do
`404`	The reference doesn't exist in this microsite. It is not an outage. Verified	Try your other microsites, then treat it as not issued.
`401` / `403`	Token rejected. Verified	Re-authenticate once, then alert. A deleted API user gives the same `401` as a wrong password.
`5xx`, `429`, timeout	Temporary failure. Verified	Retry with backoff. This call changes nothing.

The spec documents no error schema. Keep the raw body and the trace id for support. Spec

Reading bookings: every hotelservice[] field and the money model
Webhooks: when to call this endpoint
List bookings: find references by date
Booking detail: one hotel, with your externalReference

RequestCopy Anchor Link

ResponseCopy Anchor Link

Which microsite to useCopy Anchor Link

Reading the hotelCopy Anchor Link

What is not hereCopy Anchor Link

ErrorsCopy Anchor Link

RelatedCopy Anchor Link

Request

Response

Which microsite to use

Reading the hotel

What is not here

Errors

Related