WallDy API 1.0.0

Last updated: 03-Aug-2026
Recent changes: Merge branch 'fix/devportal_playground_deployment' into 'main' Fix/devportal playground deployment See merge request api-program/apigee/sales/search-apis/search-walldy!2

Overview

search-walldy exposes the WallDy holiday Offers search over a single REST endpoint. Given a set of accommodations and a search window, it returns the matching holiday offers (accommodation, board and return flights, with pricing).

Base URL

Environment URL
Prod https://prod.api.tui/search-walldy

Authentication

All requests require a valid OAuth 2.0 bearer token obtained through your Apigee client credentials. Pass it in the Authorization header:

Authorization: Bearer <access-token>

API methods

Method Resource Description
POST /offers Retrieve holiday offers for the supplied search criteria

Request

POST /offers accepts a JSON body. Key fields:

Field Type Required Description
accommodationIds string[] Yes Accommodations to search for
startDate string (YYYY-MM-DD) Yes Start of the search window
endDate string (YYYY-MM-DD) Yes End of the search window (inclusive)
searchType integer Yes Search type identifier
adults / kids / infants integer No Party composition
kidsAge integer[] No Ages of children (required when kids or infants > 0)
duration integer No Duration in nights
boardTypes string[] No Board type filter (e.g. BB, HB, FB)
departureAirports / arrivalAirports string[] No Airport filters
maxPrice number No Maximum price filter

Refer to the OpenAPI specification for the complete request schema.

Response

A 200 OK returns availability grouped per accommodation. Each offer includes the accommodation, board, outbound and inbound flight details, duration and pricing. Responses are available as application/json or streamed as application/x-json-stream.

Status Meaning
200 Offers retrieved successfully
400 Invalid request parameters
500 Internal server error

HTTP Headers

Header Name Inbound/Outbound Description
Authorization Inbound OAuth 2.0 bearer token (required)
Content-Type Inbound application/json
ordering-criteria Inbound Optional ordering of results, e.g. price-asc
X-Trace-Id Inbound Optional correlation id for request tracing

About us

TUI is one of the world’s leading tourism groups. The broad portfolio gathered under the Group umbrella consists of strong tour operators, 1,600 travel agencies and leading online portals, five airlines with around 150 aircraft, over 400 hotels, 16 cruise liners and many incoming agencies in all major holiday destinations around the globe.

 

TUI Group logo

Documentation

Overview

Getting started

Tutorials

API Catalog

Search

Travel Agencies

Flights

Accomodations

Contact

Get in touch

apiplatform@tui.com

developer.tui

Facebook logoYoutube logoTwitter logoLinkedin logoPinterest logo

Login to your account