Contract airfares. One pair of codes. JSON.
Bring GSA airfare awards into your travel, expense and ERP systems. Look up a route and travel date to retrieve published contract fares, airlines and validity periods without maintaining your own CSV lookups.
Independent of GSA and the U.S. Government. Data sourced from official public awards.
Use GSA’s three-letter codes: ABE / ATL for Allentown–Atlanta, or LON / WAS for London–Washington. Codes accept lowercase; reversing the route returns the same awards. City names and nearby airports are not expanded automatically.
Omit the date for today or supply a travel date. Results match its US fiscal year and include the source start and end dates. Both awards are returned when amendments share a boundary date.
Read the carrier code, service and five fare categories in your integration. Service N means non-stop; C means connecting. Unavailable fares are null. Results do not select a cheapest flight or establish seat availability.
Pass your API key in the request header. The response returns canonical, alphabetically ordered codes. All fares below are one-way USD, valid in either direction.
Example from the imported awards for 2026-10-29.
curl --get 'https://api.allowancesapi.com/v1/gsa/city-pairs/ABE/ATL' \
-H 'X-API-Key: YOUR_KEY' \
--data-urlencode 'date=2026-10-29' \
--data-urlencode 'verification_url=true'Use Business-level access for a dated example outside the current fiscal year.
Add X-Bypass-Cache: 1 to verify newly imported data; imports do not clear existing response-cache entries.
{
"effective_date": "2026-10-01",
"verification_url": "https://www.gsa.gov/travel/plan-a-trip/transportation-airfare-rates-pov-rates/airfare-rates-city-pair-program",
"results": [
{
"fiscal_year": 2027,
"origin_code": "ABE",
"destination_code": "ATL",
"airline_code": "DL",
"service": "N",
"effective_date": "2026-10-01",
"expiration_date": "2027-09-30",
"yca_fare": 710.0,
"ca_fare": 355.0,
"business_fare": null,
"cp_fare": null,
"cn_fare": null
}
]
}Each award includes its own validity dates. The top-level effective_date is the latest start date among matching awards, not an import timestamp. An unmatched route or unloaded year returns 404 without falling back to another date.
| JSON field | GSA fare | Meaning |
|---|---|---|
yca_fare | YCA | Last-seat coach fare |
ca_fare | _CA | Capacity-controlled coach fare |
business_fare | _CB | Business class |
cp_fare | _CP | International premium economy |
cn_fare | _CN | Non-refundable capacity-controlled fare |
Null means that fare category is unavailable, not free travel. GSA publishes no _CN awards for FY2027. Business and premium economy bookings require agency approval. See GSA’s fare definitions.
Coverage starts with imported FY2027 awards. Imported years are retained, but archived backfill and daily publication history are not included. A historical lookup uses the latest retained table and its validity dates.
Use the awards in government travel budgets, expense systems and ERP integrations where the route and travel date determine the applicable source data.
Pair airfare data with GSA per diem for lodging and meals, or GSA mileage for POV reimbursement rates.
Fare records retain the source validity period and an optional official verification link, so your application can show which award it used.
GSA calls the source the City Pair Program (CPP). Allowances API normalizes its published contract awards as JSON; it is not affiliated with GSA or the U.S. Government.
These rates do not establish traveler eligibility or live seat inventory. Book through your agency’s authorized travel system or travel management company.
Domestic fares exclude some charges, including passenger facility, segment and security fees. International fares exclude taxes and fees but include fuel surcharges. Confirm the final ticket price, baggage fees and agency requirements through the authorized booking system.
Allowances API normalizes GSA City Pair Program contract awards into JSON. Query airport or city codes and a travel date to retrieve every matching award, with its airline, service, fare categories and validity dates.
Use the codes published by GSA. Domestic routes generally use airport codes, while international routes can use metropolitan city codes such as LON for London and WAS for Washington. A city code does not automatically expand into neighboring airports. Either route direction returns the same awards.
Omit date for today. Sandbox and Google add-on access is limited to today; Pro covers the current US fiscal year; Business-level access includes any loaded year. Coverage starts with imported FY2027 awards and retains imported years. Archived years and a history of daily publication revisions are not included.
No. The API returns published government contract fares, not live seat inventory or booking offers. Traveler eligibility and agency approval still apply. Book through your agency’s authorized travel system or travel management company.
No. Allowances API is independent of GSA and the U.S. Government. Award data comes from GSA’s official public City Pair Program publications.
Start with an API key and a route, then choose the access your integration needs.
Create your account