Round-Trip Flight Search API

Search outbound and return fares in one request. The response includes both legs, the total itinerary price, baggage details, and an ignav_id for fetching booking links.

POST/api/fares/round-trip

Request body

Accepts all one-way parameters, plus:

Parameter	Type	Required	Description
return_date	string	Yes	Return date in YYYY-MM-DD format. Must be on or after departure_date.
return_time_range	object	No	Filter return flights by departure/arrival hour. Same format as departure_time_range and uses local time for the return leg's airports.

return_time_range follows the same local-time rule as outbound filters: departure fields use the return leg departure airport's local time, and arrival fields use the return leg arrival airport's local time.

Example

Open Playground

curl -X POST "https://ignav.com/api/fares/round-trip" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":"SFO","destination":"LHR","departure_date":"2026-09-24","return_date":"2026-10-01"}'

Response

{
  "origin": "SFO",
  "destination": "LHR",
  "departure_date": "2026-09-24",
  "return_date": "2026-10-01",
  "itineraries": [
    {
      "price": {
        "amount": 899,
        "currency": "USD",
        "status": "verified"
      },
      "outbound": {
        "carrier": "British Airways",
        "duration_minutes": 625,
        "segments": [
          {
            "marketing_carrier_code": "BA",
            "flight_number": "286",
            "operating_carrier_name": "British Airways",
            "departure_airport": "SFO",
            "departure_time_local": "2026-09-24T17:30:00",
            "departure_timezone": "America/Los_Angeles",
            "departure_time_utc": "2026-09-25T00:30:00Z",
            "arrival_airport": "LHR",
            "arrival_time_local": "2026-09-25T11:55:00",
            "arrival_timezone": "Europe/London",
            "arrival_time_utc": "2026-09-25T10:55:00Z",
            "duration_minutes": 625,
            "aircraft": "Airbus A380"
          }
        ]
      },
      "inbound": {
        "carrier": "British Airways",
        "duration_minutes": 660,
        "segments": [
          {
            "marketing_carrier_code": "BA",
            "flight_number": "287",
            "operating_carrier_name": "British Airways",
            "departure_airport": "LHR",
            "departure_time_local": "2026-10-01T10:00:00",
            "departure_timezone": "Europe/London",
            "departure_time_utc": "2026-10-01T09:00:00Z",
            "arrival_airport": "SFO",
            "arrival_time_local": "2026-10-01T13:00:00",
            "arrival_timezone": "America/Los_Angeles",
            "arrival_time_utc": "2026-10-01T20:00:00Z",
            "duration_minutes": 660,
            "aircraft": "Airbus A380"
          }
        ]
      },
      "cabin_class": "economy",
      "requires_self_transfer": false,
      "ignav_id": "a1b2c3d4e5f6789012345678abcdef01"
    }
  ]
}

Nonstop weekend trip

Combine max_stops with a short date range for a weekend getaway search:

Open Playground

curl -X POST "https://ignav.com/api/fares/round-trip" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":"JFK","destination":"MIA","departure_date":"2026-09-11","return_date":"2026-09-13","adults":2,"max_stops":0}'

Response fields

The response is the same as one-way. Round-trip itineraries add an inbound leg object with the same structure as outbound.

Parameter	Type	Required	Description
inbound	object	No	Inbound leg object with carrier, duration_minutes, and segments.

Related docs

Ready to get started?

Create a free account to get your API key, or try the playground — no signup required.

Get API key Try the Playground