# Munition Flight Search

> Munition Flight Search is a paid API for AI agents from api.munition.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Searches for available flight offers between two airports by date, passenger count, and cabin class, returning priced itineraries.

## Facts

- Endpoint: POST https://api.munition.io/v1/flights/search
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/munition-flight-search-b5e3a1f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t-XU52xmWgI1HlFS-2RwK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability munition-flight-search-b5e3a1f5 -d '<json body>'
```

Example prompt: Search for round-trip economy flights from SFO to NRT departing August 10 and returning August 20, for 2 adults — non-stop only, max price $600 per person.

## When to prefer this

Use this endpoint when an AI agent needs to discover and compare available flight options between two airports on specific dates, especially in agentic workflows where no pre-existing API key or airline account is needed. Ideal for anonymous, pay-per-call flight lookups via x402 micropayments without OAuth or subscription setup.

## Known failure modes

- Invalid IATA code (3-letter code doesn't match a known airport) returns a validation error
- No flights found for the given route and date returns empty results array
- maxPrice too low for any available flight returns empty results
- departureDate in the past or malformed date string returns a 400 error
- Payment failure via x402 returns 402 Payment Required
- Rate limiting or provider outage returns 5xx error

## How this service works

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.

## Output

Returns a list of flight offers, each with a unique offer ID, total price in the requested currency, full itinerary breakdown including per-segment departure and arrival times, airport codes, carrier codes, flight numbers, and number of stops, plus metadata indicating how many results were found and when the search was performed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "adults": {
   "type": "integer",
   "default": 1,
   "maximum": 9,
   "minimum": 1
  },
  "origin": {
   "type": "string",
   "maxLength": 3,
   "minLength": 3,
   "description": "IATA airport code to depart from, for example SFO."
  },
  "infants": {
   "type": "integer",
   "default": 0,
   "maximum": 9,
   "minimum": 0
  },
  "nonStop": {
   "type": "boolean",
   "description": "When true, return only offers whose itineraries have one segment each."
  },
  "children": {
   "type": "integer",
   "default": 0,
   "maximum": 9,
   "minimum": 0
  },
  "currency": {
   "type": "string",
   "maxLength": 3,
   "minLength": 3,
   "description": "Optional ISO currency code used with maxPrice."
  },
  "maxPrice": {
   "type": "number",
   "description": "Optional max total offer price. Currency conversion is not applied.",
   "exclusiveMinimum": 0
  },
  "maxResults": {
   "type": "integer",
   "default": 50,
   "maximum": 50,
   "minimum": 1
  },
  "returnDate": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
   "description": "Optional return date in YYYY-MM-DD format."
  },
  "destination": {
   "type": "string",
   "maxLength": 3,
   "minLength": 3,
   "description": "IATA airport code to arrive at, for example NRT."
  },
  "travelClass": {
   "enum": [
    "ECONOMY",
    "PREMIUM_ECONOMY",
    "BUSINESS",
    "FIRST"
   ],
   "type": "string",
   "default": "ECONOMY"
  },
  "departureDate": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
   "description": "Outbound date in YYYY-MM-DD format."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "searchedAt": "2026-05-19T00:00:00.000Z",
   "resultCount": 1
  },
  "results": [
   {
    "id": "off_example",
    "source": "flight_search",
    "currency": "USD",
    "totalPrice": "418.90",
    "itineraries": [
     {
      "duration": "PT10H15M",
      "segments": [
       {
        "arrival": {
         "at": "2026-08-11T15:00:00",
         "airportCode": "NRT"
        },
        "departure": {
         "at": "2026-08-10T12:00:00",
         "airportCode": "SFO"
        },
        "carrierCode": "BA",
        "flightNumber": "284"
       }
      ],
      "numberOfStops": 0
     }
    ],
    "airlineCodes": [
     "BA"
    ]
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/munition-flight-search-b5e3a1f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.munition.io](https://www.zero.xyz/host/api.munition.io/llms.txt)