Flight Award

Search airline award flight availability across loyalty programs

Overview

Search award flight availability — mileage costs, taxes, cabin classes, and itineraries — across major airline loyalty programs. Results are paginated; use page to fetch additional pages.

Base path: https://api.datacaiman.com/v1/flightaward

Cost: 1 credit per call

GET /v1/flightaward/search

Parameters

Name Type Required Description
origins string No* Comma-separated IATA origin codes (e.g. JFK,LAX)
destinations string No* Comma-separated IATA destination codes (e.g. LHR,CDG)
startDate string No Start date, YYYY-MM-DD (inclusive)
endDate string No End date, YYYY-MM-DD (inclusive, max 60-day range)
cabin string No economy, premium, business, first (default: any)
issuer string No Loyalty program identifier (e.g. flyingblue, aadvantage)
sortBy string No price:asc, price:desc, duration:asc, duration:desc
page integer No 1-based page number (default: 1)
pageSize integer No Results per page, max 25 (default: 25)

* At least one of origins or destinations must be provided.

Response

{
  "hasNextPage": true,
  "nextPage": 2,
  "items": [
    {
      "origin": "JFK",
      "destination": "LHR",
      "date": "2024-12-15",
      "cabin": "business",
      "miles": 57500,
      "taxes": 250.00,
      "program": "flyingblue"
    }
  ]
}

Examples

Search business class awards from New York to London in December:

curl "https://api.datacaiman.com/v1/flightaward/search?origins=JFK&destinations=LHR&startDate=2024-12-01&endDate=2024-12-31&cabin=business&sortBy=price:asc" \
  -H "X-API-Key: dc_your_key_here"

Search any award from multiple origins:

curl "https://api.datacaiman.com/v1/flightaward/search?origins=JFK,EWR,LGA&destinations=CDG&startDate=2024-11-01&endDate=2024-11-30" \
  -H "X-API-Key: dc_your_key_here"

Filter by loyalty program:

curl "https://api.datacaiman.com/v1/flightaward/search?origins=LAX&destinations=NRT&issuer=aadvantage&cabin=economy" \
  -H "X-API-Key: dc_your_key_here"
← IdealistaOfferUp →