How to Check Flight Availability and Pricing
After selecting a flight from the search results, use the availability endpoint to retrieve detailed segment information, confirmed pricing, and a cabinavailabilitytoken needed for fare rules and booking.
Endpoint
GET /flights/api/v2/availability/{cabinsearchsession_id}
Headers
| Header | Required | Description |
|---|
x-api-key | Yes | Your API key. |
x-correlation-id | Yes | Correlation ID from the autocomplete response. |
Path Parameters
| Parameter | Type | Required | Description |
|---|
cabinsearchsession_id | string | Yes | The session ID from a cabin option in the search response. |
Example Request
GET /flights/api/v2/availability/css_abc123def456
Example Response
JSON
{
"status": "success",
"data": {
"segments": [
{
"flight_number": "UA123",
"airline": "United Airlines",
"origin": "SFO",
"originairportname": "San Francisco International Airport",
"destination": "FRA",
"destinationairportname": "Frankfurt Airport",
"departure_time": "2026-04-15T10:30:00",
"arrival_time": "2026-04-16T06:45:00",
"duration": "12h 15m",
"cabin_class": "Economy",
"aircraft_type": "Boeing 787-9",
"baggage": {
"cabin_baggage": "1 x 7kg",
"checked_baggage": "1 x 23kg"
}
},
{
"flight_number": "LH456",
"airline": "Lufthansa",
"origin": "FRA",
"originairportname": "Frankfurt Airport",
"destination": "BLR",
"destinationairportname": "Kempegowda International Airport",
"departure_time": "2026-04-16T09:00:00",
"arrival_time": "2026-04-16T22:30:00",
"duration": "9h 0m",
"cabin_class": "Economy",
"aircraft_type": "Airbus A350-900",
"layover": {
"airport": "FRA",
"duration": "2h 15m"
},
"baggage": {
"cabin_baggage": "1 x 7kg",
"checked_baggage": "1 x 23kg"
}
}
],
"pricing": {
"base_price": 450,
"taxandfees": 85.5,
"total_price": 535.5,
"currency_code": "USD"
},
"ispassportrequired": true,
"hold_allowed": true,
"cabinavailabilitytoken": "cat_xyz789abc123"
},
"message": "Availability retrieved successfully"
}
Response Fields
Segments
| Field | Description |
|---|
flightnumber | Airline flight number. |
airline | Operating airline name. |
origin / destination | IATA airport codes. |
originairportname / destinationairportname | Full airport names. |
departuretime / arrivaltime | ISO 8601 timestamps. |
duration | Flight duration for this segment. |
cabinclass | Cabin class for this segment. |
aircraft_type | Aircraft model. |
layover | Layover details (present on connecting segments). Includes airport code and duration. |
baggage | Included cabin and checked baggage allowances. |
Pricing
| Field | Description |
|---|
baseprice | Base fare before taxes. |
taxandfees | Total taxes and fees. |
totalprice | Final price including all taxes and fees. |
currency_code | Currency of the quoted price (e.g., USD). |
Booking Flags
| Field | Type | Description |
|---|
ispassportrequired | boolean | Whether passport details are required during booking. If true, you must include passport information in the traveler data. |
holdallowed | boolean | Whether the booking can be held without immediate payment. |
cabinavailability_token | string | Token required for fare rules lookup and booking creation. Save this value. |
Token Chaining
The cabinavailabilitytoken returned by this endpoint is used in two downstream calls:
- Fare Rules —
GET /flights/api/v2/farerules/{cabinavailabilitytoken} - Create Booking —
POST /flights/api/v2/bookings (passed in the request body)
Make sure to store this token after a successful availability check.
Tips
- Always check availability before booking. Search results show estimated pricing; the availability endpoint provides confirmed, real-time pricing.
- If
ispassportrequired is true, ensure you collect passport details from all travelers before calling the booking endpoint. - If
hold_allowed is true, you can create the booking and confirm it later within the ticket time limit.
Related Articles
