A clean JSON API for live business, first, and economy award space — pulled direct from global airline inventory, not scraped from airline websites. Built for LLM agents, travel tools, and backend integrations.
Availability is observed and timestamped; points prices are calculated from published award charts.
Airline website redesigns and anti-bot defenses don't touch us. We query airline inventory directly, so your integration doesn't break every time a carrier ships a new front end.
Responses are plain facts: carrier, flight, route, times, cabin, and seat count — already mapped to human cabin names. No fare-code decoding, no parsing required on your end.
Surfaces long-haul business and first award space — including alliance and partner segments — that consumer airline sites and scraper tools frequently don't show.
Honest about limits: award space is volatile and released in real time, so availability changes minute to minute. A small set of carriers block their award space from open distribution entirely (e.g. Singapore Suites, Emirates First) — we don't pretend to see what isn't there.
Major carriers across Star Alliance, oneworld and SkyTeam, plus independents, queried one airline at a time. Where a carrier's space only appears under a partner's flight number, the response shows it via operated_by.
Economy, business and first. Ask for the cabin you want; results carry the cabin name, not a fare code.
Up to about 11 months ahead, which is as far as airlines release award space. One date per query: fan out across dates for flexible searches.
Not covered: carriers that withhold award space from distribution entirely (e.g. Singapore Suites, Emirates First). If a carrier is not in the GDS, it is not in the results.
Each request searches exactly one origin, one destination, one airline, and one date. For flexible searches, make one query per combination. Authenticate with a bearer token.
curl -X POST https://awardsecrets.com/api.php \
-H "Authorization: Bearer ak_live_…" \
-H "Content-Type: application/json" \
-d '{"origin":"JFK","destination":"LHR","airline":"VS","date":"2027-03-05","cabin":"business"}'
{
"status": "ok",
"quota_remaining": 4998,
"found": true,
"flight_count": 11,
"observed_at": "2026-10-10T14:05:00Z",
"dates": [
{
"date": "2027-03-05",
"observed_at": "2026-10-10T14:05:00Z",
"flights": [
{
"carrier": "VS",
"flight_number": "VS4",
"operated_by": null,
"origin": "JFK",
"destination": "LHR",
"depart": "2027-03-05T18:00",
"arrive": "2027-03-06T06:20",
"equipment": "351",
"cabin": "business",
"seats": 4
}
… 10 more
]
}
]
}
operated_by names the operating airline when it differs from the marketing airline (codeshares, e.g. "DL"); null means the marketing airline operates the flight. Rarely, the operator is given only in a form we can't yet resolve; it is then null too, and we add such names as we find them. Connections return one object per segment. Times are ISO-8601 local. seats on a segment is its count within its journey (9 means nine or more); for what is bookable use the journey's itineraries[].seats, always 1 to 8. observed_at is when that availability was observed in airline inventory (UTC); results can be up to 12 hours old.
The answer operation on the points endpoint. Send the traveller’s question in words, or the airline,
route, cabin and points they hold, and get back the cheapest programme that books that airline, the miles one way,
exactly how their card or airline points get there, the other ways to book, and which sites to check for seats.
It comes as ready-to-show markdown and as data, so you can display it as is or build your own view.
Same key, same allowance: one answer is one query.
curl -X POST https://awardsecrets.com/points.php \
-H "Authorization: Bearer ak_live_…" \
-H "Content-Type: application/json" \
-d '{"operation":"answer","question":"How do I fly ANA business from Chicago to Tokyo with Amex points?"}'
-d '{"operation":"answer","airline":"NH","origin":"ORD","destination":"HND",
"cabin":"business","points_held":["AMEX_MR"]}'
{
"status": "ok", "operation": "answer", "quota_remaining": 998,
"result": {
"answer_status": "ok",
"answer": "### ANA, ORD to HND, business\n\n**Best way with your points:** Virgin Atlantic Flying Club, 60,000 miles one way…",
"options": [ {
"airline": "NH", "airline_name": "ANA", "cabin": "business",
"best": { "programme": "VIRGIN_ATLANTIC", "miles_one_way": 60000, "surcharge_usd_approx": 50,
"book_online": false, "caveats": ["book by phone"],
"transfers": [ { "from": "AMEX_MR", "ratio": "1:1", "transfer_time": "instant", "points_needed": 60000 } ] },
"others": [ { "programme": "AEROPLAN", "miles_one_way": 85000, … },
{ "programme": "ANA_MILEAGE_CLUB", "miles_one_way": 50000, "price_type": "starting_at",
"surcharge_level": "high", … },
…one more ],
"where_to_check": "Virgin Atlantic Flying Club books this by phone, so ask its agents for seats on your date; Aeroplan (aircanada.com); …"
} ],
"basis": "Award prices from each programme's published chart or our last check of it. Not a live seat check: …"
}
}
Virgin Atlantic’s chart beats ANA’s own programme here once ANA’s surcharges (about US$600 one way) are counted. The answer says so plainly and puts the phone-only catch next to the price.
question: the fields object from an earlier answer, so a follow-up such as “what about with Chase?” keeps the route.airlines: a list of up to 3. Required when sending fields.economy, premium_economy (priced as economy, and the answer says so), business or first. Defaults to business.AMEX_MR, CHASE_UR, CITI_TY, CAPITAL_ONE, BILT) or programme codes (AVIOS, AEROPLAN…). Without it the answer assumes the main card points and says so. An unknown code is a 400, not a silent guess.YYYY-MM-DD) picks the season on seasonal charts; passengers (1–9) adds “per person”.ok, or needs_clarification when the question has no route we can work out: answer is then a question to put to the traveller, and the call is not charged (charged: false).nonstop_airlines lists the airlines we believe fly the route nonstop, and the answer covers them.best, others (up to 3), priced_by_date (programmes that book it but price by date, so no number is given), where_to_check, and note when nothing is priced.programme, miles and miles_one_way, round_trip, price_type, season_miles / peak_miles, surcharge_level and surcharge_usd_approx, book_online, caveats, where_to_book, and transfers: for each of the traveller’s currencies that reaches it, the ratio, transfer time and points needed.points_held was not given; null otherwise.Errors follow the rest of the API: a malformed request is a 400 and uses no query; if the question can’t be read (a 502), the query is given back. Prefer fields when you already know the airline and route: they skip the AI step and answer faster.
AI agents can buy a single points answer without a
membership, using the x402 payment
protocol (version 2). Send the same request to points_x402.php; the reply tells your agent what to
pay; it pays US$0.05 in USDC on Base and gets the answer, with a receipt. Any x402 client library does this for you.
curl -i -X POST https://awardsecrets.com/points_x402.php \
-H "Content-Type: application/json" \
-d '{"question":"How do I fly ANA business from Chicago to Tokyo with Amex points?"}'
{ "x402Version": 2,
"resource": { "url": "https://awardsecrets.com/points_x402.php", "mimeType": "application/json" },
"accepts": [ { "scheme": "exact", "network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "50000",
"payTo": "0x330ef8Dc8a5DCecF8d72BBc3faD8De0d99ee99c8", "maxTimeoutSeconds": 60,
"extra": { "name": "USD Coin", "version": "2" } } ] }
-H "PAYMENT-SIGNATURE: <base64 x402 v2 payment payload>"
{ "status": "ok", "operation": "answer", "charged": true,
"result": { "answer": "### ANA, ORD to HND, business …", "options": [ … ] },
"payment": { "transaction": "0x…", "network": "eip155:8453", "amount": "50000" } }
+ PAYMENT-RESPONSE header: the settlement receipt (base64)
operation (a question, or airline, origin, destination, cabin, points_held). A malformed request is a 400 before any payment is asked for.charged: false).A separate endpoint on the same key and the same monthly allowance: one pricing request counts as one query. Give it the airline that operates the flight and the route, and it returns every programme that can price it from a published award chart, cheapest first, each labelled with how the price was worked out. Programmes without a published chart are listed as unpriced, with the reason. We never estimate a number.
curl -X POST https://awardsecrets.com/points.php \
-H "Authorization: Bearer ak_live_…" \
-H "Content-Type: application/json" \
-d '{"operation":"best_path","carrier":"QR","origin":"MEL","destination":"LHR","via":["DOH"],"cabin":"business"}'
{
"status": "ok",
"quota_remaining": 999,
"operation": "best_path",
"result": {
"priced": [
{ "programme": "QATAR_PRIVILEGE_CLUB", "programme_name": "Qatar Airways Privilege Club (Avios)",
"miles": 90000, "price_type": "fixed", "pricing_basis": "journey",
"surcharge_level": "low", "as_of": "2026-10-13" },
{ "programme": "JAL_MILEAGE_BANK", "programme_name": "JAL Mileage Bank",
"miles": 110000, "price_type": "fixed", "pricing_basis": "per_trip",
"surcharge_level": "low", "as_of": "2026-10-10" },
{ "programme": "IBERIA_CLUB", "programme_name": "Iberia Club (Avios)",
"miles": 113000, "peak_miles": 148500, "pricing_basis": "per_flight_sum",
"surcharge_level": "low", "as_of": "2026-10-12" },
{ "programme": "AADVANTAGE", "programme_name": "American Airlines AAdvantage",
"miles": 122500, "price_type": "starting_at", "pricing_basis": "two_awards",
"surcharge_level": "low", "as_of": "2026-10-10" }
…three more, cheapest first
],
"unpriced": [
{ "programme": "ASIA_MILES", "unpriced_reason": "no_chart_entry" }
],
"stale_count": 1
}
}
Same trip, four programmes, four ways of pricing: Qatar's own programme prices the whole connection once by region pair; JAL prices the whole trip once on its total distance; Iberia prices each flight, with off-peak and peak; AAdvantage counts two long-haul flights as two awards. Every option carries all the fields below. The public route pages show this same pricing for every route we monitor. The request prices the trip as Qatar-operated throughout to illustrate the fields. In practice Melbourne–Doha is VA7, a Virgin Australia flight operated with a Qatar aircraft (sold as QR8402), so that journey is mixed-operator: price each operating airline separately, and expect programmes to treat the whole journey differently.
best_path (what this flight costs, by programme), chart (one programme’s chart price), programme (what a programme can book), transfers (where a card currency can transfer) or answer (the finished how-to-book answer, above).economy, business or first.["DOH"]. Needed for correct prices on connections: some programmes price each flight, others the total distance.YYYY-MM-DD. Seasonal charts (ANA’s own flights) use it to pick the season; without it they return a from price with every season listed.AMEX_MR, CHASE_UR) or programmes you hold directly (e.g. AVIOS). Omit it to price every programme that can book the flight.fixed: a published chart price. starting_at: the programme publishes minimums (show it as “from”); the actual price can be higher.true when miles is a round-trip price because the programme does not sell one-way awards on that route (ANA Mileage Club). Ranking counts it as half per direction.season is low, regular or high for the date given; season_miles lists all three. Without a date, season is null and miles is the lowest.per_trip (the whole one-way trip priced once on its total distance), per_flight / per_flight_sum (each flight priced separately; legs shows each), journey (by region or zone, origin to destination).per_flight / per_flight_sum on a connection: each flight’s price (from, to, miles). null when the trip is a single flight or is priced as a whole.peak_miles is null and peak_note says so.true when the chart behind the price is pending re-verification. Treat it as indicative and confirm before transferring points.low, moderate or high, with surcharge_usd_approx as a rough estimate.currencies_held: which of your currencies transfer to the programme, the ratio and the points needed.dynamic_pricing (no published chart, so it cannot be quoted in advance) or no_chart_entry (a chart exists, but we don’t hold this route or origin yet). We never estimate these. Unpriced entries share the option structure, but their price fields (miles, price_type, pricing_basis, legs) carry no price information: ignore them.Prices come from each programme’s published award charts and are indicative: programmes change their charts, and some publish only minimums. Confirm the price with the programme before transferring points. Coverage grows as we verify more charts; each response states exactly which programmes are priced and why the others are not.
The same search and the points answer, exposed as MCP tools. Point Claude Code, Cursor, or any MCP client at https://awardsecrets.com/mcp and award availability, and how to book it with points, become something your agent can call directly — no client code to write.
Remote transport, no local process to install. Same bearer key as the REST API.
search_award_availability takes one origin, one destination, one airline, one date: the schema tells the model to fan out rather than guess. how_to_book_with_points takes a question or fields and returns the points answer. No key? The same answer is sold per call at points_x402.php.
Availability: cabin and seat count, no fare codes. Points: chart prices only, never guessed. Nothing invented for a model to repeat.
curl -X POST https://awardsecrets.com/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -X POST https://awardsecrets.com/mcp \
-H "Authorization: Bearer ak_live_…" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"search_award_availability",
"arguments":{"origin":"JFK","destination":"LHR",
"airline":"VS","date":"2027-03-05"}}}'
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
"params":{"name":"how_to_book_with_points",
"arguments":{"question":"Virgin Atlantic upper class New York to London with Chase points"}}}'
tools/list and initialize answer without a key, so a client can discover the server before you have one. tools/call requires a key and is currently in limited release.
Membership gives you Award AI access (which loyalty programmes can book each flight, published-chart points cost, card transfer paths and alerts) and API and MCP access to the AwardSecrets data set: award availability observed through a GDS connection, with points prices from published award charts. Each plan includes a monthly fair-use allowance; there are no per-search charges. No membership? AI agents can pay per answer instead.
A query is one origin, destination, airline and date. Above your allowance, queries pause until the next month or you move up a plan; nothing is billed per search. Each plan includes Award AI access for one user; teammates can add it with the standard US$9.99/month membership.
Terms of Service — see §5 for API terms and §6 for what you may do with the data.
Yes. The AwardSecrets API returns award (points and miles) seat availability as JSON: carrier, flight number, route, times, aircraft, cabin and seat count. Each request covers one origin, one destination, one airline and one date.
The AwardSecrets data set is observed in airline inventory through a GDS under our own agreement, with points prices calculated from published award charts; it is not scraped from airline websites, so an integration does not break when a carrier redesigns its site or adds anti-bot defenses.
Yes. The same search, and the points answer (how_to_book_with_points), are available as Model Context Protocol (MCP) tools at https://awardsecrets.com/mcp. Discovery works without a key; calls need one.
Yes. The answer operation on points.php takes a question in words, or the airline, route, cabin and points held, and returns the cheapest programme that books it, the miles one way, how the traveller’s card or airline points transfer (ratio, time, points needed), surcharges, other ways to book and which sites to check for seats: as ready-to-show text and as data. One query per answer; a clarifying question back is not charged. It is pricing from programme charts, not a live seat check.
Yes. POST the same request to points_x402.php with no key. It answers HTTP 402 with a PAYMENT-REQUIRED header (x402 version 2): US$0.05 in USDC on Base. Sign the payment, send it back in a PAYMENT-SIGNATURE header, and the answer comes back with a PAYMENT-RESPONSE receipt. Payment is collected only when the answer is delivered; a clarifying question back is free.
API access is a monthly membership that gives you Award AI access (booking programmes, published-chart points cost, transfer paths and alerts) and API and MCP access to the AwardSecrets data set: award availability observed through a GDS connection, with points prices from published award charts: Sandbox US$49 (up to 1,000 queries a month) and Developer US$499 (up to 10,000), each with Award AI access for one user; Enterprise is a custom plan tailored to your business needs. Teammates can add Award AI access with the standard US$9.99/month membership. There are no per-search charges; above the allowance, queries pause until the next month or you move up a plan.
Each date lists its flight segments in journey order, and each segment carries an itinerary number: segments of one connection share it. Each date also has an itineraries summary per journey, with its segments, connecting airports, operating airline of each segment and bookable seats. Seat counts are journey-specific: airlines control connecting availability by journey, so a first leg shared by two connections can show 6 seats in one and 7 in the other. The bookable seats for a journey are the lowest count across its segments. Journeys flown by more than one airline are flagged mixed_operators (programmes price them differently), and a change of airport within a city is flagged airport_change. via lists the airport where each connection arrives; airport_change shows the arriving and departing airports (e.g. NRT→HND). In itineraries, operated_by always names an airline: the marketing airline when the flight itself is operated by it.
Journeys showing the system's maximum count (9, meaning nine or more) on every segment are withheld, because that figure often doesn't reflect bookable award seats, as are journeys with counts the aircraft's cabin cannot hold. A connection whose lowest segment is 1 to 8 is returned, so a journey's bookable seats (itineraries[].seats) are always 1 to 8; an individual segment can still show 9.
The availability endpoint returns facts only: availability, cabin and seat count, with no fare codes and no prices. Redemption pricing is a separate endpoint (points.php) on the same key and allowance: published award-chart prices by programme, each labelled with how it was worked out, whether it is a fixed price or a published minimum, and whether the chart is pending re-verification. Programmes without a published chart are listed as unpriced, never estimated.
Every response includes observed_at: when that availability was observed in airline inventory (UTC, ISO 8601). When an identical query has run recently, a result showing availability can be up to 12 hours old, and a "nothing available" result up to 90 minutes old. Use observed_at to show your users how recent each result is.
We may add new fields at any time, so your client should ignore fields it doesn't recognise. We won't remove or change existing fields without notice to members. Changelog: 10 Oct 2026, added observed_at (top level and per date). 11 Oct 2026 (v1.2.0): redemption pricing endpoint, points.php. 11 Oct 2026 (v1.3.0): journeys: itinerary on each flight, itineraries per date with bookable seats, itinerary_count. 11 Oct 2026 (v1.4.0): pricing: optional date, round_trip, season and season_miles; ANA Mileage Club priced. 12 Oct 2026 (v1.4.1): no field changes. Connections where only some segments show 9 are now returned (journeys are judged by their lowest segment; before, any segment showing 9 withheld the journey). Documentation clarified: operated_by null, via and airport_change, legs, price_type on unpriced options. 18 Oct 2026 (v1.5.0): no change to responses; documents fields already returned: each reachable_from entry (currency, ratio, points_needed, transfer_time, bonus), where points_needed is rounded up to whole transfer blocks; confidence, pricing_model, surcharge fields and valuation_cpp; pricing_basis values two_awards, mixed_journey and mixed_per_flight_sum; and the full list of programme codes (x-programme-codes in the OpenAPI spec). New programmes: Aer Lingus AerClub, China Southern Sky Pearl Club, EVA Air Infinity MileageLands, Finnair Plus, Thai Royal Orchid Plus and Vietnam Airlines Lotusmiles; Etihad Guest, JAL Mileage Bank, Qatar Privilege Club and Velocity cover more partner airlines. 31 Oct 2026 (v1.6.0): searched (true when the airline's availability was checked); when it is false, not_searched_reason (airline_not_covered or search_incomplete) and not_searched_detail are added, and the call uses no quota. 2 Nov 2026 (v1.6.1): no field changes. airline_not_covered now also answers, without searching, a cabin AwardSecrets cannot see on an airline it otherwise covers: British Airways and American Airlines business and first; Garuda Indonesia, TAROM, Aeromexico and Cathay Pacific economy; and Middle East Airlines and Air India in every cabin. Airlines whose award space is not visible (for example Singapore Airlines) are now reported as airline_not_covered, not search_incomplete. airline_not_covered is permanent: do not retry. 5 Nov 2026 (v1.6.2): no field changes. airline_not_covered also answers, without searching, an airline outside the routes AwardSecrets can see it on: British Airways economy only on routes to or from the United States and Canada, and ANA only between the United States and Japan. 6 Nov 2026 (v1.6.3): no field changes. Iberia: award seats on Iberia's own flights are not visible to AwardSecrets, so Iberia now returns airline_not_covered in every cabin. Avios prices for other airlines' flights are unchanged. 6 Nov 2026 (v1.6.4): no field changes. Qatar Airways and Cathay Pacific: award seats on their own flights are not visible to AwardSecrets, so both now return airline_not_covered in every cabin. Points prices for other airlines' flights in their programmes are unchanged. 17 Nov 2026 (v1.6.5): no field changes. United, Air Canada, Lufthansa, SWISS, Austrian, Brussels Airlines and ANA: award seats on their own flights are not reliably visible to AwardSecrets in any cabin, so each now returns airline_not_covered in every cabin (the 5 Nov ANA route limit is replaced by this). Points prices for their flights are unchanged. 18 Nov 2026 (v1.7.0): new points operation answer: how to book a flight with the points you have, as a ready-to-show answer and as data (best way, other ways, transfers, surcharges, where to check seats); and a second MCP tool, how_to_book_with_points. Existing operations and fields are unchanged. 18 Nov 2026 (v1.8.0): pay per answer over x402, no key needed: POST /points_x402.php, US$0.05 in USDC on Base per answer, collected only when the answer is delivered. Membership keys and allowances are unchanged.
About 11 months: dates up to roughly 330 days ahead. Airlines release award space around then, so later dates cannot have availability yet.
Start a Sandbox or Developer membership online: sign in with Google, pay securely with Stripe, and your API key arrives by email within a minute. Enterprise plans are tailored to your business.
Enterprise, or questions: api@awardsecrets.com
Already a member? Your account · Cancel any time.