Flights integration

FlightGPT calls your API when a traveller searches, and shows every flight you return with your price and a deeplink to book it. You can implement the request and response below — the FlightGPT Partner API — or send us your existing API documentation and we map it to this.

Search request

We send a POST with a JSON body to the URL you give us, with your authentication header. We send one leg per request; a return trip is two one-way searches today.

POST https://api.youragency.in/fgpt/flights/search
X-API-Key: <the key you issue us>
Content-Type: application/json

{
  "legs": [ { "from": "DEL", "to": "BOM", "date": "2026-10-20" } ],
  "adults": 2,
  "children": 1,
  "infants": 0,
  "cabin": "economy",
  "currency": "INR",
  "locale": "en-IN"
}

Field	Meaning
`legs`	Origin and destination as 3-letter IATA airport codes, date as YYYY-MM-DD.
`adults`	1–9.
`children`	0–9, aged 2–11.
`infants`	0–9, under 2, never more than adults.
`cabin`	`economy`, `premium_economy`, `business` or `first`.
`currency`	Always `INR`.

Search response

{
  "itineraries": [
    {
      "price": { "total": 18450, "currency": "INR", "per_adult": 6310, "per_child": 5830, "per_infant": 0, "refundable": false },
      "legs": [
        {
          "segments": [
            {
              "airline": "6E", "airline_name": "IndiGo", "flight_number": "2134",
              "operating_airline": "6E", "cabin": "economy",
              "from": "DEL", "to": "BOM",
              "depart": "2026-10-20T06:40:00", "arrive": "2026-10-20T08:55:00"
            }
          ]
        }
      ],
      "duration_min": 135,
      "baggage": { "checkin_kg": 15, "cabin_kg": 7 },
      "deeplink": "https://www.youragency.in/book?fare=6E2134-DEL-BOM-20OCT-Q1&pax=2-1-0"
    }
  ]
}

Field	Meaning
`price.total`	Required. Total for all passengers, every mandatory charge included — see the pricing rules.
`price.currency`	Required. `INR`. Other currencies are dropped.
`price.refundable`	Optional. `true` / `false`; shown to the traveller.
`legs[].segments[]`	Required. One segment per flight, in order. Airline codes are 2-letter IATA; times are local to each airport, `YYYY-MM-DDTHH:MM:SS`.
`duration_min`	Optional but recommended: total journey minutes. Without it we compute from the times, which is wrong across time zones.
`baggage`	Optional. Included check-in and cabin allowance per passenger.
`deeplink`	Required. https link to your booking page for this exact fare and passenger mix.

Itineraries without a positive total, an INR price or an https deeplink are not shown. Flights whose first segment does not leave from the searched origin on the searched date are not shown either.

Deeplinks

The deeplink should open your booking or summary page with this flight already selected, not a fresh search. We add the click id to it (see conversion tracking); tell us if you need other tracking parameters. The traveller is sent through https://flightgpt.in/r/…, which records the click and redirects to your link.

Speed and caching

We wait up to 8 seconds for your answer, then show the other partners' deals without yours.
We cache your answer for 30 minutes by default. Tell us if your fares need a shorter time.
If you only serve some routes, send us the list of origin–destination pairs so we don't query you for the rest.

Also send us

Your logo: 200 × 70 px, PNG or SVG.
Your payment methods and any payment charges, if they are not all free.
If you restrict API access by IP, allow 69.62.85.241.