Browse API endpoints

Get a seat map

Inspect the cabin layout, seat features, and available seats for a flight on a specific date.

POSThttps://apisv2.awardtoolapi.com/api/seatmap

Also available at POST /utility/seatmap.

Example request

Shell
curl --request POST \
  'https://apisv2.awardtoolapi.com/api/seatmap' \
  --header 'Content-Type: application/json' \
  --data '{
  "flight": {
    "id": "VS20",
    "airlineCode": "VS",
    "flightNo": "20",
    "departureDate": "2027-02-15",
    "departure": "SFO",
    "arrival": "LHR",
    "cabinClass": "E"
  },
  "api_key": "YOUR_API_KEY"
}'

Use the operating carrier and the departure date for a single flight segment. Match availability to the cabin layout by seat label.

Request body

flightobject · Required
The operating flight, departure date, airports, and cabin.
flight.idstring · Required
Full operating flight number, including the carrier code.
flight.airlineCodestring · Required
IATA code of the operating carrier.
flight.flightNostring · Required
Flight number without the carrier code.
flight.departureDatestring · Required
Scheduled departure date in YYYY-MM-DD format.
flight.departurestring · Required
Three-letter departure airport code.
flight.arrivalstring · Required
Three-letter arrival airport code.
flight.cabinClassstring · Required
Cabin code for the seat map, such as E for economy.
api_keystring · Required
Your AwardTool API key.

Example response

JSON · response excerpt
{
  "status": 200,
  "data": [
    {
      "id": "VS20",
      "seatDetails": {
        "decks": [
          {
            "level": 1,
            "rows": [
              {
                "number": 57,
                "classCode": "E",
                "seats": [
                  {
                    "letter": "A",
                    "name": "Economy"
                  }
                ]
              }
            ]
          }
        ]
      }
    },
    {
      "id": "availabilityData",
      "availableSeats": [
        {
          "label": "57A",
          "price": 0,
          "currency": "EUR"
        }
      ]
    }
  ]
}

Response fields

data
Look up the flight layout by flight number and the availability record by its id, availabilityData.
seatDetails.decks
Decks contain rows and seats with their labels, features, and positions.
cabin
Cabin dimensions and seat configuration. Amenities can appear alongside it under wifi, power, and entertainment.
availableSeats
Seat labels currently available for selection, with a price and currency where supplied.
View original API reference