For AI agents & developers
Onward Flight sells verified flight reservations (proof of onward travel): a real, airline-verifiable PNR for visa applications and immigration. An AI agent can price, buy, and manage a reservation end-to-end — no human checkout required.
Quickstart for agents
- Read the OpenAPI discovery document at
/api/openapi.json. - Optionally get a firm price with
POST /api/agentic/quote. - Call
POST /api/agentic/flight-booking. The first call returns402with a payment challenge; retry with anAuthorization: Payment <token>header to complete the purchase. - Receive the booking id, PNR(s), and a magic link for the traveler.
Agentic API
POST
/api/agentic/quoteFirm price before paying (breakdown + total + advisory expiry).
POST
/api/agentic/flight-bookingHeadless purchase via the Machine Payments Protocol (HTTP 402 payment challenge). Returns booking id, PNR(s), and a magic link.
GET
/api/agentic/booking/{id}Booking status: state, PNR(s), route, hold expiry.
POST
/api/agentic/booking/{id}/refund-requestFile a refund request (manual, discretionary review — does not move money).
Public APIs (no auth)
GET
/api/airports?keyword=Airport / city autocomplete.
GET
/api/products/publicActive product catalog and pricing.
POST
/api/flights/searchSearch bookable itineraries.
GET
/api/reservations/{pnr}Public reservation status lookup.
Pricing (USD, from)
- One-way reservation: $16.00 per passenger
- Round-trip: +$7.00 flat surcharge
- Activate later add-on: $2.00
- Flexible reservation add-on: $8.00
Discovery & integration
- OpenAPI (agentic / MPP discovery) https://onwardflight.co/api/openapi.json
- llms.txt https://onwardflight.co/llms.txt
- AI plugin manifest https://onwardflight.co/.well-known/ai-plugin.json
- OAuth authorization server metadata https://onwardflight.co/.well-known/oauth-authorization-server
- OpenID configuration https://onwardflight.co/.well-known/openid-configuration
- MCP server (Model Context Protocol) https://mcp.onwardflight.co/mcp
Policies
- Terms & conditions https://onwardflight.co/terms-and-conditions
- Privacy policy https://onwardflight.co/privacy-policy
- Refund policy https://onwardflight.co/refund-policy
- Dispute policy https://onwardflight.co/dispute-policy
Contact
Support: support@onwardflight.co