Search flights

POST

api

flights

curl -X POST "https://api.staging.ttool.travel/hub/api/v1/flights/search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "adults": 1,
    "cabinType": "Economy",
    "flightType": "OneWay",
    "segments": [
      { "origin": "BGW", "destination": "DXB", "departureDate": "2026-12-07" }
    ]
  }'

curl -X POST "https://api.staging.ttool.travel/hub/api/v1/flights/search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "adults": 1,
    "children": 0,
    "infants": 0,
    "cabinType": "Economy",
    "flightType": "RoundTrip",
    "segments": [
      { "origin": "BGW", "destination": "DXB", "departureDate": "2026-12-07", "originType": "AirportCode", "destinationType": "AirportCode" },
      { "origin": "DXB", "destination": "BGW", "departureDate": "2026-12-14", "originType": "AirportCode", "destinationType": "AirportCode" }
    ]
  }'

{
  "requestId": "3f1a1c9e-7b2d-4c7e-9a1f-2b3c4d5e6f70",
  "returningRequestId": null,
  "offers": [
    {
      "offerId": "8d0e3b6a-2f41-4b8e-b1c9-5d6e7f8a9b0c",
      "tripType": "RoundTrip",
      "cabinClass": "Economy",
      "hasFareBrands": true,
      "supportsOnHold": false,
      "price": { "currency": "USD", "total": 436.00, "baseFare": 360.00, "taxes": 76.00, "commission": 12.00 },
      "journeys": [ { "...": "outbound" }, { "...": "inbound" } ]
    }
  ],
  "returningOffers": [],
  "dictionaries": {
    "carriers": { "FZ": "flydubai", "IA": "Iraqi Airways" },
    "airports": {
      "BGW": { "name": "Baghdad International", "city": "Baghdad", "country": "IQ" },
      "DXB": { "name": "Dubai International", "city": "Dubai", "country": "AE" }
    }
  }
}

{
  "success": false,
  "error": {
    "errorCode": "INVALID_REQUEST_FORMAT",
    "httpStatusCode": 400,
    "errorDetails": {
      "segments": ["RoundTrip searches take exactly two segments: the outbound and the return."]
    }
  }
}

A search takes 5 to 90 seconds depending on the route. Set your client timeout to at least 120 seconds. Results come back once the search is complete. Limited to 3 per second and 600 per 15 minutes.

Body

integer

required

1 to 9.

integer

default:"0"

0 to 4, aged 2 to 11.

integer

default:"0"

0 to 4, under 2. Never more than adults.

string

default:"Economy"

Economy, PremiumEconomy, Business or First.

string

required

OneWay or RoundTrip.

object[]

required

Exactly 1 for OneWay. Exactly 2 for RoundTrip: the outbound first, then the return with origin and destination swapped.

Show properties

string

required

3-letter IATA airport code, or city code when originType is CityCode.

string

required

3-letter IATA code. Must differ from origin.

string

required

yyyy-MM-dd. Between today and one year ahead. The return can’t be before the outbound.

string

default:"AirportCode"

AirportCode or CityCode.

string

default:"AirportCode"

AirportCode or CityCode.

Response

string (uuid)

Identifies this search. Every later call for offers in offers needs it. Searches expire: if an offer comes back not found or expired, search again.

Offer[]

Offers in the platform’s default order, cheapest first. For a round trip these are normally complete outbound plus return combinations. See the offer object.

string | null

Only set for a split round trip.

Offer[]

Only filled for a split round trip.

object

Names for every carrier and airport code used in this response’s offers. See Dictionaries.

Round trips come back combined or split. Your code must handle both. See Round trips. An empty offers with HTTP 200 means no availability, not an error.

curl -X POST "https://api.staging.ttool.travel/hub/api/v1/flights/search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "adults": 1,
    "cabinType": "Economy",
    "flightType": "OneWay",
    "segments": [
      { "origin": "BGW", "destination": "DXB", "departureDate": "2026-12-07" }
    ]
  }'

curl -X POST "https://api.staging.ttool.travel/hub/api/v1/flights/search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "adults": 1,
    "children": 0,
    "infants": 0,
    "cabinType": "Economy",
    "flightType": "RoundTrip",
    "segments": [
      { "origin": "BGW", "destination": "DXB", "departureDate": "2026-12-07", "originType": "AirportCode", "destinationType": "AirportCode" },
      { "origin": "DXB", "destination": "BGW", "departureDate": "2026-12-14", "originType": "AirportCode", "destinationType": "AirportCode" }
    ]
  }'

{
  "requestId": "3f1a1c9e-7b2d-4c7e-9a1f-2b3c4d5e6f70",
  "returningRequestId": null,
  "offers": [
    {
      "offerId": "8d0e3b6a-2f41-4b8e-b1c9-5d6e7f8a9b0c",
      "tripType": "RoundTrip",
      "cabinClass": "Economy",
      "hasFareBrands": true,
      "supportsOnHold": false,
      "price": { "currency": "USD", "total": 436.00, "baseFare": 360.00, "taxes": 76.00, "commission": 12.00 },
      "journeys": [ { "...": "outbound" }, { "...": "inbound" } ]
    }
  ],
  "returningOffers": [],
  "dictionaries": {
    "carriers": { "FZ": "flydubai", "IA": "Iraqi Airways" },
    "airports": {
      "BGW": { "name": "Baghdad International", "city": "Baghdad", "country": "IQ" },
      "DXB": { "name": "Dubai International", "city": "Dubai", "country": "AE" }
    }
  }
}

{
  "success": false,
  "error": {
    "errorCode": "INVALID_REQUEST_FORMAT",
    "httpStatusCode": 400,
    "errorDetails": {
      "segments": ["RoundTrip searches take exactly two segments: the outbound and the return."]
    }
  }
}

curl -X POST "https://api.staging.ttool.travel/hub/api/v1/flights/search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "adults": 1,
    "cabinType": "Economy",
    "flightType": "OneWay",
    "segments": [
      { "origin": "BGW", "destination": "DXB", "departureDate": "2026-12-07" }
    ]
  }'

curl -X POST "https://api.staging.ttool.travel/hub/api/v1/flights/search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "adults": 1,
    "children": 0,
    "infants": 0,
    "cabinType": "Economy",
    "flightType": "RoundTrip",
    "segments": [
      { "origin": "BGW", "destination": "DXB", "departureDate": "2026-12-07", "originType": "AirportCode", "destinationType": "AirportCode" },
      { "origin": "DXB", "destination": "BGW", "departureDate": "2026-12-14", "originType": "AirportCode", "destinationType": "AirportCode" }
    ]
  }'

{
  "requestId": "3f1a1c9e-7b2d-4c7e-9a1f-2b3c4d5e6f70",
  "returningRequestId": null,
  "offers": [
    {
      "offerId": "8d0e3b6a-2f41-4b8e-b1c9-5d6e7f8a9b0c",
      "tripType": "RoundTrip",
      "cabinClass": "Economy",
      "hasFareBrands": true,
      "supportsOnHold": false,
      "price": { "currency": "USD", "total": 436.00, "baseFare": 360.00, "taxes": 76.00, "commission": 12.00 },
      "journeys": [ { "...": "outbound" }, { "...": "inbound" } ]
    }
  ],
  "returningOffers": [],
  "dictionaries": {
    "carriers": { "FZ": "flydubai", "IA": "Iraqi Airways" },
    "airports": {
      "BGW": { "name": "Baghdad International", "city": "Baghdad", "country": "IQ" },
      "DXB": { "name": "Dubai International", "city": "Dubai", "country": "AE" }
    }
  }
}

{
  "success": false,
  "error": {
    "errorCode": "INVALID_REQUEST_FORMAT",
    "httpStatusCode": 400,
    "errorDetails": {
      "segments": ["RoundTrip searches take exactly two segments: the outbound and the return."]
    }
  }
}

Get started

Guides

Reference

API endpoints

Body

Response

​Body

​Response

Body

Response