Table of Contents

Airline Search API Documentation

Overview

This API provides a searchable list of airlines worldwide, returning IATA airline codes along with their corresponding full names. Results are paginated for efficient data handling.


API Endpoint

  • URL: {{host}}/hub/b2c/flight/airlines/search
  • Method: POST
  • Content-Type: application/json

Headers

Key Value Description
Content-Type application/json Request/Response format

Request Body

Empty JSON object (No parameters required for basic search):

{}

Sample Request

curl --location '{{host}}/hub/b2c/flight/airlines/search' \
--header 'Content-Type: application/json' \
--data '{}'


Sample Response

{
  "durationInMilisecond": 46,
  "totalCount": 1036,
  "totalPage": 52,
  "pageSize": 20,
  "pageIndex": 0,
  "clientOverride": false,
  "data": [
    { "id": "ZY", "name": "SKY AIRLINES" },
    { "id": "ZX", "name": "PIVOT AIRLINES" },
    { "id": "ZW", "name": "AIR WISCONSIN" },
    { "id": "ZV", "name": "AEROTRANSPORTES RAFILHER" },
    { "id": "ZU", "name": "ETHIOPIAN MOZAMBIQUE" },
    { "id": "ZT", "name": "" },
    { "id": "ZS", "name": "" },
    { "id": "ZR", "name": "" },
    { "id": "ZQ", "name": "GERMAN AIRWAYS" },
    { "id": "ZP", "name": "PARANAIR" },
    { "id": "ZN", "name": "ZAMBIA AIRWAYS" },
    { "id": "ZL", "name": "REGIONAL EXPRESS" },
    { "id": "ZK", "name": "" },
    { "id": "ZJ", "name": "" },
    { "id": "ZH", "name": "SHENZHEN AIRLINES" },
    { "id": "ZG", "name": "ZIPAIR TOKYO" },
    { "id": "ZF", "name": "AZUR AIR" },
    { "id": "ZE", "name": "EASTAR JET" },
    { "id": "ZD", "name": "EWA AIR" },
    { "id": "ZB", "name": "AIR ALBANIA" }
  ]
}

Response Field Description

Main Response

Field Type Description
durationInMilisecond Number API processing time in milliseconds
totalCount Integer Total number of airlines in database
totalPage Integer Total pages of results
pageSize Integer Number of items per page (default: 20)
pageIndex Integer Current page index (0-based)
clientOverride Boolean Indicates custom client configurations
data Array List of airline objects (see below)

Airline Object

Field Type Example Description
id String "ZY" 2-letter IATA airline code
name String "SKY AIRLINES" Full airline name (empty if unknown)

Notes

  • Empty name fields indicate airlines where official names aren't available in the system
  • IATA codes (id field) are always populated when available
  • Use pageIndex and pageSize for pagination control