Flight Availability Search API - Overview

What is the Flight Availability Search API?

The Flight Availability Search API is a RESTful web service that provides real-time flight availability and pricing information. It serves as the first step in the booking process, enabling applications to search for available flights before proceeding with reservations.

Purpose

This API enables:

• Travel Booking Platforms: Integrate flight search capabilities into booking applications
• Partner Integrations: Enable third-party partners to access flight inventory and pricing
• Mobile Applications: Provide flight search functionality for mobile apps

Key Capabilities

Real-Time Availability

• Search across multiple airlines and routes
• Get up-to-date seat availability
• Support for direct flights and multi-leg journeys (up to 2 stopovers)

Comprehensive Pricing

• Detailed fare breakdowns including base fare, taxes, fees, and surcharges
• Separate pricing for adults, children, and infants
• Both gross and net pricing
• Multiple fare classes per flight

Flexible Search Options

• Trip Types: One-way and round-trip searches
• Date Ranges: Search across flexible date ranges
• Multi-Airport: Search from/to multiple airports simultaneously
• Country-Level: Search all airports within specified countries
• Carrier Filtering: Limit results to specific airlines
• Result Grouping: Organize by route or date
• Result Limiting: Control response size

Role-Based Access

• Agent-specific pricing based on authentication
• Secure journey and fare keys for booking workflows
• Encrypted identifiers for sensitive operations

Use Cases

Customer Flight Search

Power customer-facing search interfaces where travelers can:

• Search for flights by origin, destination, and dates
• Compare prices across different dates and airlines
• View available seats and fare options
• Select flights for booking

Multi-City Search

Enable complex itineraries:

• Search multiple origin airports
• Search multiple destination airports
• Find best combinations for multi-city trips

Agent Booking Tools

Support travel agent workflows:

• Agent-specific net pricing
• Quick availability checks
• Fare comparison across dates

Target Audience

• Frontend Developers: Building web and mobile booking interfaces
• Backend Developers: Integrating flight search into booking systems
• System Integrators: Connecting third-party platforms

Technical Highlights

• Protocol: RESTful HTTP/HTTPS
• Data Format: JSON
• Authentication: OAuth 2.0
• Versioning: URL-based (v2)

Getting Started

1. Obtain OAuth 2.0 credentials from the developer portal
2. Contact yoda@tui.de with your app name and required AgentName for mapping
3. Review API documentation
4. Test integration in Test environment
5. Implement using code examples