Get a seat map
Inspect the cabin layout, seat features, and available seats for a flight on a specific date.
POST
https://apisv2.awardtoolapi.com/api/seatmapAlso 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.