Connect API for Accommodations (1.18)
The connectAPI for accommodations defines a service API that lets users search for, view, book, and cancel accommodations via TripBuilder.
Key Features:
- Get List of Accommodations: Retrieves a list of all available accommodations, including basic details like code, room description, and price.
- Get Accommodation Details: Provides detailed information about a specific accommodation using its reference.
- Check Accommodation Availability: Shows the current availability status of an accommodation along with its description.
- Book an Accommodation: Allows users to book an accommodation offer using its reference and user details.
- Cancel Booking: Enables users to cancel a booking using its booking reference.
This API is designed to be RESTful, using standard HTTP methods like GET, POST, and DELETE, and it primarily exchanges data in JSON format.
| API Version | Docs Version | Changes |
|---|---|---|
| 1.0 | 31.07.2023 | Initial version |
| 1.1 | 05.06.2024 | Extended spec to support Book and Cancel actions |
| 1.2 | 04.10.2024 | Extended spec to split offer between search and details offer. |
| Added support for available board codes and cancellation policies in search offer model. | ||
| Removed deprecated location field from search and details offer | ||
| 1.3 | 28.01.2025 | Added 'filters' object to AccommodationOffersRequest and AccommodationOfferDetailsRequest |
| Updated documentation with supplier currently supported by Nezasa | ||
| 1.4 | 07.08.2025 | Added NBC (Non-Bookable Content) import endpoint for hotel static data synchronization |
| 1.5 | 05.11.2025 | Made 'added' and 'updated' fields optional in NBC Dates schema |
| 1.6 | 10.01.2026 | BREAKING: NBC images field now uses ImageGroup[] with nested ImageResolution[] for multi-resolution image support |
| 1.7 | 04.02.2026 | Added requiredPassengerData and requiredContactData to AccommodationDetailsOffer |
| 1.8 | 25.02.2026 | Added travelAgentEmail, travelAgentFirstName, travelAgentLastName, travelAgencyShortName, travelAgencyEmail to Metadata |
| 1.9 | 20.04.2026 | Made Contract-Id optional, added Login and Password headers as alternative identification method |
| 1.10 | 08.05.2026 | Added maxPriceVariationPercentage to AccommodationBookingRequest to let callers tolerate small price changes at booking time (applied to increases only when the supplier API allows it; symmetric otherwise) |
| 1.11 | 08.05.2026 | BREAKING: NBC import endpoint now accepts a languages: string[] array (replacing the single language: string) and returns NBCHotelData.descriptions as an array of LocalizedDescription (one entry per requested language). The redundant tourOperator request field has been removed (caller is identified via Contract-Id / Login / Password headers). |
| 1.11.1 | 28.07.2026 | Documentation only, no schema change: clarified that AccommodationAvailabilityResponse.accommodation must be omitted entirely when no offer is available (not sent as null or as an empty object), and that TripBuilder reads its absence as "no availability". |
| 1.12 | 19.08.2026 | Deprecated accommodationName on AccommodationSearchOffer and AccommodationDetailsOffer. The field should no longer be populated and will be removed in a future version. |
| 1.13 | 20.08.2026 | Deprecated availableCancellationPolicies, availableBoardCodes and availableSuppliers on AccommodationSearchOffer. The fields should no longer be populated and will be removed in a future version. |
| 1.14 | 27.08.2026 | Flagged the already-documented deprecations in the spec: accommodations on AccommodationOffersResponse and AccommodationOfferDetailsResponse, and notifications on those responses and on AccommodationAvailabilityResponse, are now marked deprecated. The fields should no longer be populated and will be removed in a future version. |
| 1.15 | 16.09.2026 | Made ratings optional on NBCHotelData. |
| 1.16 | 20.10.2026 | Added optional flights to AccommodationBookingRequest: the travellers' flights before and after the stay, to arrange included airport transfers. |
| 1.17 | 27.10.2026 | Added optional amenities to NBCHotelData: hotel-level amenities as a closed list of AmenityCode values. Deprecated facts; it will be removed in a future version. |
| 1.18 | 05.11.2026 | Added optional rooms to NBCHotelData: static content of the property's room types. |
All API requests must be made over HTTPS.
Identification can be provided via either:
- A
Contract-Idheader identifying the contract configuration LoginandPasswordheaders for login-based authentication
The identification method should be agreed with Nezasa before integration development starts. Both methods may be provided simultaneously if required by the integration.
Servers
production mock server
https://connectapi.stg.nezasa.com