---
title: "Search live flight offers through direct x402"
method: POST
path: "/v1/flights/search"
tags: ["Flights"]
---

# Search live flight offers through direct x402

`POST /v1/flights/search`

## Request

- Base URL: `https://api.munition.io`
- URL: `https://api.munition.io/v1/flights/search`
- Auth: none required

Munition Flight Search: x402-paid live flight offer search for AI agents. Pay 0.05 USDC to search Duffel flight offers and receive compact normalized itineraries, prices, carriers, and metadata suitable for replay and downstream planning.

## Request body

- SearchFlightsInput
  - `origin` string, required: IATA airport code to depart from, for example SFO.
  - `destination` string, required: IATA airport code to arrive at, for example NRT.
  - `departureDate` string, required: Outbound date in YYYY-MM-DD format.
  - `returnDate` string: Optional return date in YYYY-MM-DD format.
  - `adults` integer
  - `children` integer
  - `infants` integer
  - `travelClass` 'ECONOMY' | 'PREMIUM_ECONOMY' | 'BUSINESS' | 'FIRST'
  - `nonStop` boolean: When true, return only offers whose itineraries have one segment each.
  - `maxResults` integer
  - `maxPrice` number: Optional max total offer price. Currency conversion is not applied.
  - `currency` string: Optional ISO currency code used with maxPrice.

## Response `200`

Paid flight search results

- SearchFlightsOutput
  - `results` object[], required
    - `id` string, required
    - `source` 'flight_search', required
    - `totalPrice` string, required
    - `currency` string, required
    - `airlineCodes` string[], required
    - `itineraries` object[], required
      - `duration` string
      - `numberOfStops` integer, required
      - `segments` object[], required
        - `departure` object, required
          - `airportCode` string
          - `at` string
        - `arrival` object, required
          - `airportCode` string
          - `at` string
        - `carrierCode` string
        - `operatingCarrierCode` string
        - `flightNumber` string
        - `aircraft` string
        - `duration` string
  - `meta` object, required
    - `resultCount` integer, required
    - `searchedAt` string, date-time, required
  - `warnings` string[]

## Other responses

- `402`: x402 payment required or settlement failed

---

[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)