other · Listed · Found · 21 endpoints · Gateway-eligible
BRIJ Travel API
BRIJ Travel API
Flights in four steps, each paid per call with x402 (USDC on Solana). 1. POST /air/search — find live offers. Price is dynamic: 0.10 USDC x1..50 depending on load, so always read the current PAYMENT-REQUIRED challenge rather than reusing a price you saw earlier. 2. POST /air/intents — lock one offer_id and derive its escrow. Costs 0.10 USDC. The response carries the intent id, the customer_support_code (PERSIST BOTH — the support code cannot be re-read later and is required to read the order or request a refund) and passenger_count: how many passengers /air/book must supply. 3. POST /air/book — send intent_id and exactly passenger_count passengers in the body, LEAD PASSENGER FIRST (the lead receives all emails and is the identity for refund requests; duplicate travellers are refused). The price is this intent's escrow amount, i.e. the ticket total for all passengers, quoted in the challenge. Booking is asynchronous: a 200 means the request was accepted, then poll GET /air/intents/{intent_id} until status is booked or refunded. 4. POST /air/refund-requests — optional, 0.10 USDC. Needs intent_id in the body plus the X-Customer-Support-Code header and X-Passenger-Family-Name: the LEAD passenger's family name. It files a request for manual review; it does not execute a refund. Action POSTs never take an id in the path: send intent_id in the request body of POST /air/book and POST /air/refund-requests. The two GET reads (GET /air/intents/{intent_id}, GET /air/orders/{order_id}) are path-addressed. If the upstream price moved between steps 2 and 3 the booking is rejected and the escrow is refunded automatically to the refund wallet frozen at intent creation. To drill into one offer (fresh price/expiry, paid-ancillary prices such as extra bags), POST /air/offer-details with the offer_id — cheaper than re-searching. Seat maps and legal fare-rule text remain unobtainable: when a decision depends on them, say so to the customer rather than guessing. Never answer "no fare with property X exists" from a truncated ungrouped search: pricier variants (refundable, with bags, higher cabin) sort to the tail and fall off. Use cheapest_per_itinerary=true and read fare_options. Hotels follow the same escrow: POST /hotels/search (0.10, all-in total_from per hotel; GET /hotels/places?q= is free) → POST /hotels/rates {hotel_id} (0.01) → POST /hotels/quote {rate_id} (0.01, returns offer_id "hotel:<quote_id>") → POST /hotels/intents {offer_id, funding_wallet} (0.10, PERSIST customer_support_code) → POST /hotels/book {intent_id, guests (lead first, one per room at least), email, phone_number} paying the intent's escrow amount → POST /hotels/orders {intent_id} + X-Customer-Support-Code (0.01) until confirmed. A refused booking refunds in full automatically; POST /hotels/cancel cancels and files the refund the hotel's cancellation terms allow. Tell the guest what is due at the hotel on top of the total (due_at_hotel_amount + due_at_hotel_currency on the quote, e.g. city tax).
Indexed from this operator's public /.well-known/x402.json. Found is not operator-owned and is not attested. Claim or opt out.
Agent Read · Cleared Index
ROUTE
Route when you need other at published x402 prices.
confidence
78%
source
signal
Index before you pay. Same payload for agents:
GET /api/cleared/agent-read?slug=brij-travel-api-26uv
When to call
- Need other via x402 and want Cleared-indexed payTo with a live scorecard.
- Budget between $0.01 and $0.10 per call on published endpoints.
- Flights in four steps, each paid per call with x402 (USDC on Solana). 1. POST /air/search — find live offers. Price is dynamic: 0.10 USDC x1..50 depending on load, so always read the current PAYMENT-REQUIRED challenge rather than reusing a price you saw earlier. 2. POST /air/intents — lock one offer_id and derive its escrow. Costs 0.10 USDC. The response carries the intent id, the customer_support_code (PERSIST BOTH — the support code cannot be re-read later and is required to read the order or request a refund) and passenger_count: how many passengers /air/book must supply. 3. POST /air/book — send intent_id and exactly passenger_count passengers in the body, LEAD PASSENGER FIRST (the lead receives all emails and is the identity for refund requests; duplicate travellers are refused). The price is this intent's escrow amount, i.e. the ticket total for all passengers, quoted in the challenge. Booking is asynchronous: a 200 means the request was accepted, then poll GET /air/intents/{intent_id} until status is booked or refunded. 4. POST /air/refund-requests — optional, 0.10 USDC. Needs intent_id in the body plus the X-Customer-Support-Code header and X-Passenger-Family-Name: the LEAD passenger's family name. It files a request for manual review; it does not execute a refund. Action POSTs never take an id in the path: send intent_id in the request body of POST /air/book and POST /air/refund-requests. The two GET reads (GET /air/intents/{intent_id}, GET /air/orders/{order_id}) are path-addressed. If the upstream price moved between steps 2 and 3 the booking is rejected and the escrow is refunded automatically to the refund wallet frozen at intent creation. To drill into one offer (fresh price/expiry, paid-ancillary prices such as extra bags), POST /air/offer-details with the offer_id — cheaper than re-searching. Seat maps and legal fare-rule text remain unobtainable: when a decision depends on them, say so to the customer rather than guessing. Never answer "no fare with property X exists" from a truncated ungrouped search: pricier variants (refundable, with bags, higher cabin) sort to the tail and fall off. Use cheapest_per_itinerary=true and read fare_options. Hotels follow the same escrow: POST /hotels/search (0.10, all-in total_from per hotel; GET /hotels/places?q= is free) → POST /hotels/rates {hotel_id} (0.01) → POST /hotels/quote {rate_id} (0.01, returns offer_id "hotel:<quote_id>") → POST /hotels/intents {offer_id, funding_wallet} (0.10, PERSIST customer_support_code) → POST /hotels/book {intent_id, guests (lead first, one per room at least), email, phone_number} paying the intent's escrow amount → POST /hotels/orders {intent_id} + X-Customer-Support-Code (0.01) until confirmed. A refused booking refunds in full automatically; POST /hotels/cancel cancels and files the refund the hotel's cancellation terms allow. Tell the guest what is due at the hotel on top of the total (due_at_hotel_amount + due_at_hotel_currency on the quote, e.g. city tax).
Risks
- Found — not operator-owned; claim status unknown.
- No Cleared settlement receipt on file yet.
- No Gateway traffic yet — market share unproven.
Price posture
Published 21 endpoints from $0.01 to $0.10.
Category · Gateway
other · no Gateway routes yet — early / unproven on Cleared market share.
Endpoint hints
POST /air/bookThe intent id travels in the request body; the resource URL is static. Paid x402 endpoint. The payment challenge is dynamic for the intent: `payTo` is the inten
POST /air/intentsPaid x402 endpoint. Send a valid `PAYMENT-SIGNATURE` header to create the intent. Without payment, the API returns `402 Payment Required`. Optional request fie
POST /air/offer-detailsPaid x402 endpoint: $0.01 USDC (an offer from a browser-automation tier would cost $0.10, a real browser session at the supplier; none is on sale today). The PA
GET /air/orders/{order_id}Returns the booking reference and the airline order's status. If all you need is the PNR, GET /air/intents/{intent_id} carries it for free as booking_reference.
POST /air/refund-requestsThe intent id travels in the request body; the resource URL is static. Paid x402 endpoint. Send a valid `PAYMENT-SIGNATURE` header to record the refund request.
POST /air/searchFlight search can be paid with x402 or sponsored by the BRIJ gateway. For direct x402 clients, send a valid `PAYMENT-SIGNATURE` header. Without payment, the AP
POST /hotels/bookPaid x402 endpoint: the intent's escrow amount. Body: intent_id, guests[] (the lead first, then at least one per room, each {given_name, family_name, born_on?})
POST /hotels/cancelPaid x402 endpoint: $0.10 USDC. Body {intent_id}; headers X-Customer-Support-Code and X-Passenger-Family-Name (the lead guest's family name). Cancels at the hot
Evidence (Cleared)
- → Intake verified · Gateway-eligible
- → Trust 70/100 · pass · tier listed
- → Protocol x402
- → Manifest reachable · schema valid
- → Found listing — indexed from public x402.json, not operator-attested.
Endpoints
Pay the escrow and request booking.
$MeteredPOST https://brij.fi/air/bookThe intent id travels in the request body; the resource URL is static. Paid x402 endpoint. The payment challenge is dynamic for the intent: `payTo` is the intent escrow address, `asset` is the expected escrow mint, and `amount` is the expected escrow amount. After x402 settlement, the API records the passenger list (lead first), verifies exact escrow funding on-chain, and enqueues the booking worker. Airline payment and escrow capture happen asynchronously. If booking fails after x402 settlement, retry the same `/book` call; excess funds remain refundable to `refund_wallet`. Booking is asynchronous: poll GET /air/intents/{intent_id} until booked or refunded.
Create an escrow-backed booking intent from a selected offer.
$0.10POST https://brij.fi/air/intentsPaid x402 endpoint. Send a valid `PAYMENT-SIGNATURE` header to create the intent. Without payment, the API returns `402 Payment Required`. Optional request field referrer: an affiliate code (see POST /affiliates) — the resolved affiliate wallet is frozen on the intent and credited a share of the platform fee once the booking captures and the journey is flown without refund; unknown or self-referring codes are silently ignored. Creates the local booking intent and initializes its Solana escrow. This does not fund the escrow, pay the airline, or issue a ticket. **Send an offer_id back EXACTLY as received.**
Drill into one offer: every fare, bag prices, live price.
$0.01POST https://brij.fi/air/offer-detailsPaid x402 endpoint: $0.01 USDC (an offer from a browser-automation tier would cost $0.10, a real browser session at the supplier; none is on sale today). The PAYMENT-REQUIRED challenge always quotes the applicable price. Re-fetches the offer from the flight provider and returns it in the same shape as search results, with CURRENT price and expires_at, plus available_services: the purchasable extras (checked bags with weight limits and prices) on that exact fare. fare_options lists EVERY fare of this flight (same aircraft, every brand: Basic, Standard, Flex…), fresh from the supplier and price-ascending, each with its own bookable offer_id — including fares the search left out of its page. Pick the row you want and pass its offer_id to POST /air/intents. Use it to (1) answer "how much is an extra bag on this fare?" or "is this fare refundable?" — the ancillary/conditions questions search results cannot answer — and (2) revalidate a single offer minutes after a search, which is cheaper and quota-friendlier than re-searching. A stale or unknown offer_id returns 404 and the payment is never settled: refusals cost nothing. Offers expire roughly 20-30 minutes after search; on 404, re-search. Services are informational only: this API books the fare as-is and cannot add services to the order.
Fetch airline order status.
$0.01GET https://brij.fi/air/orders/{order_id}Returns the booking reference and the airline order's status. If all you need is the PNR, GET /air/intents/{intent_id} carries it for free as booking_reference. Paid x402 endpoint at a token $0.01 USDC, and still gated by the X-Customer-Support-Code returned at intent creation. Refusals are never charged: a missing or wrong code (401/403) or an unknown order (404) happens before the payment settles. Note the response distinguishes an unknown order (404) from a wrong code (403).
Request a manual refund after the intent has been booked.
$0.10POST https://brij.fi/air/refund-requestsThe intent id travels in the request body; the resource URL is static. Paid x402 endpoint. Send a valid `PAYMENT-SIGNATURE` header to record the refund request. Without payment, the API returns `402 Payment Required`. Records a refund request for a booked intent. The on-chain escrow has already been captured by the time the intent is `booked`, so refunds at this stage are processed manually by an operator. This endpoint persists the request and pages the operator on Telegram; the response is `202 Accepted` and is **not** a guarantee of refund — eligibility and any applicable carrier penalties are reviewed manually. For pre-capture states (`active`), the booking_sync worker handles refunds automatically; this endpoint returns `409 use_automatic_refund` for those. The caller must include the `X-Customer-Support-Code` header matching the code returned at intent creation. For multi-passenger bookings, X-Passenger-Family-Name is the LEAD passenger's family name (position 0 of the /air/book list).
Search live flight offers.
$MeteredPOST https://brij.fi/air/searchFlight search can be paid with x402 or sponsored by the BRIJ gateway. For direct x402 clients, send a valid `PAYMENT-SIGNATURE` header. Without payment, the API returns `402 Payment Required` carrying the **current** price. For BRIJ Wallet preview calls, the gateway may send `X-BRIJ-SPONSORED-*` headers. Providers should treat that as a BRIJ-sponsored preview, not as a user-paid x402 settlement. Every price in the response is the price a buyer pays: total_amount / total_amount_decimal (offers, fare_options, highlights) are all-in, and max_price filters on that figure. POST /air/intents asks exactly this amount as expected_escrow_amount (a wallet enrolled in a fee-waiving cohort is asked less, never more). Base x402 price is 0.10 USDC. The price is multiplied (up to 50×) by the current search load: completed searches in the last 60 seconds and any upstream rate-limit response in the last 5 minutes. Always read the latest `PAYMENT-REQUIRED` challenge before signing - the price your client saw a moment ago may already be stale. The same flight commonly appears several times at different prices: each offer is one fare (fare_brand_name, baggage, change/refund conditions) sold by one seller (owner_name). Two offers on the same flight can share identical conditions and differ only in seller and price — compare the fare fields, never assume cheaper means more restrictive. **Data boundaries — what this response does and does not contain.** Each offer carries EVERYTHING the flight inventory provider discloses at search time: itinerary (legs, times with IANA timezones, durations, aircraft, terminals, technical stops), identity (comparison_key, both carriers on codeshares, flight numbers, fare_basis_code), fare content (brand, cabin, included baggage, change/refund conditions with penalties), price breakdown (base + tax), CO2 estimate, and loyalty programmes. To drill into ONE offer — fresh price/expiry and paid-ancillary prices — use POST /air/offer-details. Filters (max_stops, departure_after/before, max_price) apply before sort, grouping and limit — so limit + sort=duration + max_stops=0 means "the fastest directs". Offers default to cheapest first; a full response can exceed 300 KB, so LLM-driven agents should send cheapest_per_itinerary=true with a limit and drill into finalists. Not available in SEARCH results (use POST /air/offer-details per offer): - Prices of paid ancillaries (extra checked bags and other extras). - Seat maps and specific seat availability. - Full legal fare-rule text. It does not exist upstream in machine form: the structured conditions object IS the complete machine-readable ruleset. For airline-side research, fare_basis_code plus the marketing carrier identifies the exact fare. Everywhere in this response, null/empty means the airline did not disclose the value — unknown, never zero or false. **Anti-pattern — truncation without grouping.** cheapest_per_itinerary=false combined with a small limit returns the N cheapest fare INSTANCES, not the N cheapest itineraries. Basic/Lite fares are always cheaper than Comfort/Flex/refundable/business variants of the SAME flight, so the pricier variants sort to the tail and fall off — and their absence from a truncated response proves nothing. To answer "is there a refundable / with-bag / higher-cabin fare?", always use cheapest_per_itinerary=true and read fare_options; it is lossless on price, brand, refund/change conditions and checked bags. **Progressive results.** The response may carry `status: enriching` plus a `search_id`: slower, cheaper fulfiller tiers are still quoting. Poll the free POST /air/search-updates with that `search_id` (every ~`poll_after_ms`) to receive their offers as they land, until `status: complete` — usually under 2 minutes. Do not choose an offer before then: the slower tiers often carry airlines the fast tier does not (other carriers' nonstops, notably) and cheaper fares. While enriching, the response also says this in words, in `next`.
Pay the hotel escrow and name the guests
$MeteredPOST https://brij.fi/hotels/bookPaid x402 endpoint: the intent's escrow amount. Body: intent_id, guests[] (the lead first, then at least one per room, each {given_name, family_name, born_on?}), email and phone_number (E.164) of the lead guest, optional special_requests (forwarded to the hotel). Every check (guests, price unchanged, nothing booked yet) happens before settle. Then the stay is booked at Duffel once the escrow is funded: poll POST /hotels/orders until status is confirmed (booking_reference set, escrow captured, confirmation emailed) or failed (refunded in full).
Cancel a hotel booking and file its refund
$0.10POST https://brij.fi/hotels/cancelPaid x402 endpoint: $0.10 USDC. Body {intent_id}; headers X-Customer-Support-Code and X-Passenger-Family-Name (the lead guest's family name). Cancels at the hotel now. The refund is what the cancellation timeline returns at this moment, plus the service fee minus 2 % of the stay (between 2 and 5 USDC); it is sent to the refund wallet set at intent creation. A non-refundable rate returns only that part of the fee.
Create the escrow for a quoted hotel stay
$0.10POST https://brij.fi/hotels/intentsPaid x402 endpoint: $0.10 USDC. Identical to POST /air/intents with the offer_id from POST /hotels/quote. The escrow amount is the quote's ALL-IN total. Persist customer_support_code: it cannot be read again, and POST /hotels/orders and /hotels/cancel need it.
Get a hotel booking's status and reference
$0.01POST https://brij.fi/hotels/ordersPaid x402 endpoint: $0.01 USDC. Body {intent_id}; header X-Customer-Support-Code. status awaiting_payment → booking → confirmed (booking_reference, escrow captured) | failed | cancelled | refunded; booking carries the full confirmation (hotel, dates, guests, key collection, cancellation terms).
Lock one hotel rate and get its exact all-in price
$0.01POST https://brij.fi/hotels/quotePaid x402 endpoint: $0.01 USDC. Body {rate_id} from POST /hotels/rates. Answer: the stay as it will be booked (hotel, address, room, board, check-in/out dates and times, party, cancellation timeline, price with tax, fees, our service fee and what is due at the hotel) and offer_id ("hotel:<quote_id>"): pass it to POST /hotels/intents. Show the guest the price, what is due at the hotel and the cancellation terms before creating the intent. Refusals are free.
List the rooms and rates of one searched hotel
$0.01POST https://brij.fi/hotels/ratesPaid x402 endpoint: $0.01 USDC. Body {hotel_id} from POST /hotels/search. Answer: room_types[], each with rates[]: rate_id (send it to POST /hotels/quote), board (room only, breakfast...), refundable, refundability and cancellation_timeline (what is refunded until when), price (hotel total with tax and fees, service fee, ALL-IN total, due at hotel). Rates paid at the hotel are not listed. Refusals are free.
Search hotels for dates and a party in one city
$0.10POST https://brij.fi/hotels/searchPaid x402 endpoint: $0.10 USDC. Body: a place (city_id from GET /hotels/places, or one hotel by accommodation_id from its hotels[], or location as a city name, or latitude + longitude with radius_km), check_in_date and check_out_date (YYYY-MM-DD, up to 30 nights), rooms (1-4, default 1), adults (1-8, default 1), child_ages, free_cancellation_only, stars (e.g. [4, 5]), sort (price | price_desc). Answer: hotels[] cheapest first, each with hotel_id (send it to POST /hotels/rates), name, rating, address, price_from (the hotel's total for the whole stay), total_from (ALL-IN, USDC: + 5 USDC + 2 %, capped at 30) and due_at_hotel_from (paid at the hotel, on top: city tax, resort fees). Refusals are free.
Add paid minutes to your open sandbox lease
$MeteredPOST https://brij.fi/sandbox/extendPaid x402 endpoint: $0.03 USDC per minute, like POST /sandbox/start (never waived over MCP). minutes 1 to 60 (one-minute steps: keep a machine open while your owner chats and pay for what you use), a lease is at most 120 minutes in total. Checked before payment (409 lease_too_long, 410 lease_ended); the clock moves only once the payment settled.
Rent a Linux computer + browser for N minutes
$MeteredPOST https://brij.fi/sandbox/startPaid x402 endpoint: $0.03 USDC per minute, browser included, 5 to 60 minutes, paid once up front (minutes × 0.03, e.g. 15 minutes = 0.45 USDC). Over MCP too: this is a sale, not a toll, so it is NEVER waived — retry the tool with the payment. Opens a disposable Ubuntu machine (1 vCPU, 3 GB RAM, 4 GB disk; node 22, python 3, git, curl, jq, playwright clients) and a separate Browserbase browser already connected to it: inside, connect with playwright connectOverCDP(process.env.BROWSER_WS_URL). Optional env: your own variables (a model API key, an MCP token…), passed to every command, masked in your owner's log. No model is included: `minirouter-signup` inside opens your own pay-as-you-go account. Answers lease_token (KEEP IT: shown once, every other call needs it), view_url (give it to your owner: every command, the browser live, your transcript written with `brij-log`), expires_at. One open lease per wallet; refused before payment when the service is full (503 sandbox_capacity) or disabled. Unused minutes are not refunded. With home_id, the machine keeps its /workspace between leases (rent per task, keep the state). Everything in the machine is destroyed at the end. Rules: no captcha solving or anti-bot evasion, no abuse of third parties; a breach ends the lease and blocks the wallet.
Pay a Shop order's escrow; BRIJ buys at the store
$MeteredPOST https://brij.fi/shopcom/buyPays the intent's escrow with x402 (amount = expected_escrow_amount, payTo = the intent's escrow), like POST /air/book; a wallet that cannot sign x402 may instead send expected_escrow_amount USDC to the intent's vault_address and then call this: a funded vault buys with no second payment. BRIJ then loads its card, completes the store's checkout through Shop and captures the escrow once the store confirms the order; if the store cannot be paid, the escrow refunds in full. Answer: the order (status awaiting_payment, buying, ordered or failed). Poll POST /shopcom/orders.
Lock a Shop quote in an escrow
$0.10POST https://brij.fi/shopcom/intentsPaid x402 endpoint: $0.10 USDC. Identical to POST /air/intents with the offer_id from POST /shopcom/quote. The escrow amount is the quote's ALL-IN total_usdc. Persist customer_support_code: it cannot be read again, and POST /shopcom/orders and refund requests need it. During the beta only invited wallets can create one (403 shopcom_beta_only).
Shop order status
$0.01POST https://brij.fi/shopcom/ordersPaid x402 endpoint: $0.01 USDC. The order of a Shop intent: status (awaiting_payment, buying, ordered, failed), the store's figures, what was paid and the store's order number once ordered. Needs the X-Customer-Support-Code returned at intent creation.
Read one Shop product
$MeteredPOST https://brij.fi/shopcom/productPaid x402 endpoint: $0.01 USDC. One product from Shop's catalog (id gid://shopify/p/… from POST /shopcom/search, or a store's product URL) with every variant, its price and seller, relayed untouched.
Quote a Shop purchase to an address
$MeteredPOST https://brij.fi/shopcom/quotePaid x402 endpoint: $0.01 USDC. Opens a real checkout at the store through Shop, shipped to ship_to, and prices it in USDC: the store's total (items, shipping, tax, converted at the day's rate plus a margin when the store does not charge USD) + BRIJ's fee. Answer: offer_id ("shopcom:<quote>"), the store's figures, total_usdc, expires_at (about 20 minutes). Stores whose checkout carries an add-on are quoted too (BRIJ approves the payment as the account holder); a store whose checkout needs something else (a check Shop cannot pass for an agent) answers 409 not_agent_ready (look for the same item at another seller). Show the buyer the item, the store, the address and total_usdc before creating the intent. Refusals are free.
Search Shop's catalog
$MeteredPOST https://brij.fi/shopcom/searchPaid x402 endpoint: $0.01 USDC. Shop's own catalog search (millions of Shopify stores), relayed untouched: products with their variants, prices, sellers (seller.url is the store's domain) and variant ids. Pass a variant id and its seller's domain to POST /shopcom/quote.
Checks
reachable
valid
2026-11-19T17:17:20.293Z
No settlement evidence found in chain signals.
Gateway routing
Score ≥70/100 — Cleared attestation pass. Route via Gateway before pay.
Claim to manage this card — or go straight to Cleared attestation ($49/mo).
Claim listing