Overview

This endpoint calculates the points price for a specified flight itinerary across supported programs.

Endpoint

/awards/search

Base URL

https://api.awardcharts.com/v1

Full URL

https://api.awardcharts.com/v1/awards/search

HTTP Method

POST

Authentication

Read here.

Example Request

Below is an example request with all supported parameters provided.

{
  "originAirport": "HND",
  "destinationAirport": "SFO",
  "operatingCarrier": "NH",
  "date": "2025-04-01",
  "itineraryType": "direct",
  "cabinClass": "economy",
  "outputPrograms": ["flying_club", "flying_blue"]
}

Example Response

{
  "programs": {
    "flying_club": {
      "prices": {
        "economy": 45000
      }
    },
    "flying_blue": {
      "prices": {
        "economy": 75000
      },
      "remarks": [
        "calculation_offset",
        "deval_announced"
      ]
    }
  }
}

Request Parameters

The following parameters are supported:

originAirport

Required

True

Description

The departure airport for the itinerary.

Type

Expected Input

3-letter IATA airport code.

Expected Output

The request will target the specified origin airport code.

Example

{
  "originAirport": "HND"
}

destinationAirport

Required

True

Description

The arrival airport for the itinerary.

Type

Expected Input

3-letter IATA airport code.

Expected Output

The request will target the specified destination airport code.

Example

{
  "destinationAirport": "SFO"
}

operatingCarrier

Required

True

Description

The airline operating the flight.

Type

Expected Input

2-letter IATA airline code.

Expected Output

The request will target the programs that support the specified carrier.

Example

{
  "operatingCarrier": "NH"
}

date

Required

True

Description

The date of travel for the itinerary.

Type

Expected Input

ISO 8601 date format (YYYY-MM-DD).

Expected Output

The request will target the pricing for the specified date, taking into account seasonal pricing and blackout dates.

Example

{
  "date": "2025-04-01"
}

itineraryType

Required

True

Description

Specifies whether the itinerary is a direct flight or includes connection(s).

Type

Expected Input

One of the following: direct, connecting

Expected Output

The request will only support direct flights, connecting flights will yield no results.

Example

{
  "itineraryType": "direct"
}

cabinClass

Required

• True: Required when fareClass is specified

• False: Not required when fareClass is unspecified

Description

The cabin class for the itinerary.

Type

Expected Input

One of the following: economy, premium, business, first

Expected Output

The request will output only the specified cabin, or output all supported cabins.

Example

{
  "cabinClass": "economy"
}

outputPrograms

Required

False

Description

The desired programs which should be provided in the output.

Type

Expected Input

An array of supported loyalty program names.

Expected Output

The request will only output the specified programs, or output all supported programs when unspecified.

Example

{
  "outputPrograms": ["flying_club", "flying_blue"]
}

Response Fields

The following response fields are returned:

programs

Description

Container object holding all supported programs for the requested itinerary.

Type

Object

programs.[program_id]

Description

Object containing all results for a supported program.

Type

Object

programs.[program_id].prices

Description

Object containing the prices for all available cabin classes.

Type

Object

programs.[program_id].prices.[cabin_class]

Description

The number of points required for the specified cabin class.

Type

Number

programs.[program_id].remarks

Description

A list of remarks related to this program and the requested itinerary/carrier combination. See remarks for all possible remarks.

Type