# Rafid Intelligence Network — Flight Search API

> Rafid Intelligence Network — Flight Search API is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-29).

Searches for available flight offers between two locations for given dates, passengers, and cabin class, returning sorted and filtered results.

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/travel/flight-search?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-intelligence-network-flight-search-api-c2eadbfa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FXdMtOIEpPXBKui2NRdzv

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 rafid-intelligence-network-flight-search-api-c2eadbfa -d '<json body>'
```

Example prompt: Search for round-trip economy flights from Muscat (MCT) to Dubai (DXB) for 2 adults departing November 24 2026 and returning November 27 2026, sorted by price, and show me up to 20 results in USD.

## When to prefer this

Use this endpoint when an AI agent needs structured, live flight search results across a broad set of routes and cabin classes, with flexible sorting and passenger configuration. It is particularly suitable when integrating travel planning into multi-domain agent workflows (alongside property, logistics, or business planning) via the Rafid Intelligence Network, and when paying per-call via x402/USDC is acceptable. Prefer alternatives if you need seat-level booking, ancillary services, or infant pricing support.

## Known failure modes

- No flight offers returned (empty offers array) when no routes match the query
- Invalid date format causing request rejection
- Origin or destination not recognized by the upstream provider
- Upstream provider (letsfg) unavailable or returning errors, reflected in provider status field
- Exceeding maximum passengers or stops constraints causing validation error
- Currency code not supported by upstream adapter

## How this service works

Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.

## Output

Returns a JSON object containing the echoed query parameters, a list of flight offers (with price, duration, stops, and other details), the total count of results, data mode (live), provider name and status, upstream latency in milliseconds, and the timestamp of the search.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "price",
    "duration",
    "stops"
   ],
   "type": "string",
   "default": "price"
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 50,
   "minimum": 1
  },
  "adults": {
   "type": "integer",
   "default": 1,
   "maximum": 9,
   "minimum": 1
  },
  "origin": {
   "type": "string",
   "pattern": "^[\\p{L}\\p{N} .,'()-]+$",
   "maxLength": 100,
   "minLength": 2
  },
  "infants": {
   "type": "number",
   "const": 0,
   "default": 0,
   "description": "Infant pricing is not supported by this adapter."
  },
  "children": {
   "type": "integer",
   "default": 0,
   "maximum": 8,
   "minimum": 0
  },
  "currency": {
   "type": "string",
   "default": "USD",
   "pattern": "^[A-Z]{3}$"
  },
  "maxStops": {
   "type": "integer",
   "maximum": 3,
   "minimum": 0
  },
  "cabinClass": {
   "enum": [
    "economy",
    "premium_economy",
    "business",
    "first"
   ],
   "type": "string",
   "default": "economy"
  },
  "returnDate": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
  },
  "destination": {
   "type": "string",
   "pattern": "^[\\p{L}\\p{N} .,'()-]+$",
   "maxLength": 100,
   "minLength": 2
  },
  "departureDate": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 0,
  "query": {
   "sort": "price",
   "limit": 20,
   "adults": 1,
   "origin": "MCT",
   "infants": 0,
   "children": 0,
   "currency": "USD",
   "cabinClass": "economy",
   "returnDate": "2026-11-27",
   "destination": "DXB",
   "departureDate": "2026-11-24"
  },
  "offers": [],
  "dataMode": "live",
  "provider": {
   "name": "letsfg",
   "status": "ok",
   "upstreamLatencyMs": 0
  },
  "searchedAt": "2026-10-04T00:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-intelligence-network-flight-search-api-c2eadbfa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.rafidsystem.com](https://www.zero.xyz/host/api.rafidsystem.com/llms.txt)