{"uid":"cap_SBiiGf-7eh4GKgokHbbQW","slug":"brij-flight-search-0e921506","name":"BRIJ Flight Search","description":"Flight search can be paid with x402 or sponsored by the BRIJ gateway.\n\nFor direct x402 clients, send a valid `PAYMENT-SIGNATURE` header. Without\npayment, the API returns `402 Payment Required` carrying the **current** price.\n\nFor BRIJ Wallet preview calls, the gateway may send `X-BRIJ-SPONSORED-*`\nheaders. Providers should treat that as a BRIJ-sponsored preview, not as a\nuser-paid x402 settlement.\n\nBase x402 price is 0.10 USDC. The price is multiplied (up to 50×) by the\ncurrent search load: completed searches in the last 60 seconds and\nany upstream rate-limit response in the last 5 minutes. Always read\nthe latest `PAYMENT-REQUIRED` challenge before signing - the price\nyour client saw a moment ago may already be stale.\n","url":"https://travel.brij.fi/air/search","method":"POST","headers":{},"bodySchema":{"type":"object","required":["origin_iata","destination_iata","depart_date"],"properties":{"adults":{"type":"integer","default":1,"minimum":1},"depart_date":{"type":"string","format":"date","example":"2026-06-10"},"origin_iata":{"type":"string","example":"MAD","maxLength":3,"minLength":3},"destination_iata":{"type":"string","example":"LIS","maxLength":3,"minLength":3}}},"responseSchema":{"type":"object","required":["search"],"properties":{"search":{"type":"object","required":["request_id","offers"],"properties":{"offers":{"type":"array","items":{"type":"object","required":["id","owner_name","origin_iata","destination_iata","departing_at","arriving_at","total_amount","total_amount_decimal","total_currency","requires_instant_payment"],"properties":{"id":{"type":"string","example":"off_0000B5xGbDG4ifAoeDTtG9"},"expires_at":{"type":"string","format":"date-time"},"owner_name":{"type":"string","example":"Air Europa"},"arriving_at":{"type":"string","format":"date-time"},"origin_iata":{"type":"string","example":"MAD"},"departing_at":{"type":"string","format":"date-time"},"total_amount":{"type":"integer","format":"int64","example":67600000,"description":"Atomic amount used by the API for money comparisons."},"passenger_ids":{"type":"array","items":{"type":"string"}},"total_currency":{"type":"string","example":"USD"},"destination_iata":{"type":"string","example":"LIS"},"payment_required_by":{"type":"string","format":"date-time"},"total_amount_decimal":{"type":"string","example":"67.60"},"requires_instant_payment":{"type":"boolean"},"price_guarantee_expires_at":{"type":"string","format":"date-time"}}}},"request_id":{"type":"string","example":"orq_0000B5xGbA4yXTVomvGU2G"}}}}},"example":null,"exampleRequest":null,"tags":["x402","shopping"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HitQyFIdOziIH_2LyRKWD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for available one-way flights between two airports on a given date, returning a list of fare offers with pricing and timing details.","exampleAgentPrompt":"Find me available flights from Madrid (MAD) to Lisbon (LIS) on June 10, 2026 for 2 adults — show me the options with prices and departure times.","exampleUseCases":[{"title":"Compare weekend flight options and pricing","prompt":"What one-way flights can I book from New York (JFK) to Los Angeles (LAX) this Saturday? Show me what's available with departure times and total fares."},{"title":"Search international airfare on a budget","prompt":"I need to fly from Paris (CDG) to London (LHR) on July 15th for just myself. Can you find me the cheapest one-way options available that day?"},{"title":"Plan group travel with multiple passengers","prompt":"We're looking for flights from Chicago (ORD) to Miami (MIA) on August 3rd for 4 passengers. What airlines and prices do you have available?"}],"resultDescription":"Returns a search object containing a request_id and an array of flight offers. Each offer includes the offer ID, airline name (owner_name), origin and destination IATA codes, departure and arrival datetimes, total fare in both atomic integer and decimal string formats, currency code, offer expiry, price guarantee expiry, payment deadline, passenger IDs, and a flag indicating whether instant payment is required.","failureModes":["402 Payment Required — no valid PAYMENT-SIGNATURE header provided; response includes current price challenge (may be higher than cached price due to load multiplier up to 50×)","400 Bad Request — missing required fields (origin_iata, destination_iata, or depart_date), or IATA codes not exactly 3 characters","No offers returned — no flights available for the requested route/date combination","Stale price signature — price has changed due to load since client last fetched 402 challenge; must re-fetch current price before signing","Upstream rate limit — search load surcharge applies for next 5 minutes after upstream provider rate-limits"],"whenToPreferThis":"Use this endpoint when you need to search one-way flight availability and pricing between two IATA-coded airports on a specific date, and your client supports x402 micropayment headers or BRIJ-sponsored preview calls. Prefer this over generic travel APIs when you need real-time fare offers with price guarantees and atomic pricing data suitable for programmatic booking flows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:34:06.350Z","isFirstParty":false}