---
title: "Generate external flight search links"
method: POST
path: "/v1/tools/flight-booking-links"
tags: ["Flights"]
---

# Generate external flight search links

`POST /v1/tools/flight-booking-links`

## Request

- Base URL: `https://api.munition.io`
- URL: `https://api.munition.io/v1/tools/flight-booking-links`
- Auth: none required

Free external flight search links for KAYAK and Kiwi.com from airports and dates. No account, authentication, payment or provider request. These links start new searches; they do not reserve a flight or guarantee a previously displayed fare. No affiliate tracking or commission is configured.

## Request body

- FlightBookingLinksInput
  - `origin` string, required: Departure IATA airport code, for example JFK.
  - `destination` string, required: Arrival IATA airport code, different from origin, for example SFO.
  - `departureDate` string, date, required: Valid outbound calendar date in YYYY-MM-DD format.
  - `returnDate` string, date: Optional return date on or after departure. Omit for a one-way search.

## Response `200`

External search URLs and their limitations

- FlightBookingLinksOutput
  - `kind` 'external_flight_search', required
  - `search` object, required
    - `origin` string, required: Departure IATA airport code, for example JFK.
    - `destination` string, required: Arrival IATA airport code, different from origin, for example SFO.
    - `departureDate` string, date, required: Valid outbound calendar date in YYYY-MM-DD format.
    - `returnDate` string, date: Optional return date on or after departure. Omit for a one-way search.
  - `links` object[], required
    - `provider` 'kayak' | 'kiwi', required
    - `label` string, required
    - `url` string, uri, required
  - `notice` string, required: Explains that these are new searches, not a reservation or guaranteed fare.

## Other responses

- `400`: Invalid airports, dates or unsupported fields

---

[API](https://skmtc.dev/munition/apis/munition-api.md) · [All operations](https://skmtc.dev/munition/apis/munition-api/llms.txt) · [OpenAPI document](https://skmtc.dev/munition/apis/munition-api/revisions/3b11109809d1?raw)