What is it?
The CKI Flight Arrivals API returns a list of flights arriving into a specific airport on a specific date.
Why use it?
You can use the CKI Flight Arrivals API to retrieve the arrival flights for a defined time, date and have the option to filter flights based on their flight status.
How it works
The CKI flight arrivals API displays all active flight dates, as defined by the airline. Flight initialization runs approximately 72 hours prior to departure. If the flight requested is not initialized the service will return "flightCount" equal to zero.
On successful execution, the service includes a list of arrival flights, flight leg status, flight schedule status, passenger counts per cabin, airport information, and counts of passengers with an associated SSR.
How to use
The flight arrivals API facilitate to retrieve a list of arriving flights to a particular city using below options. • Carrier Display Option: -
HOST_ONLY- This will list only flights operated by the host carrier.
HOST_AND_GROUND_HANDLED– This will list all Host carrier flights as well as any ground handled flights.
SPECIFIC_GROUND_HANDLED_CARRIER– This will list all flights for a specific ground handled carrier that has been provided in ground handled carrier.
Note: groundHandledCarrier (string, optional) works with CarrierDisplayOption = SPECIFIC_GROUND_HANDLED_CARRIER, if it is not mentioned, it means any/all carriers are ground handled.
• Flight Leg Status: -Below are the values for flight leg status
CLOSED- Inhibits Local check-in of a flight, to transmit final passenger count data to the load agent. Allows the downline station to assume control of the flight.
HELD- Inhibits all non-control workstations from check-in access to a specific flight leg. Placing a flight leg in held status allows you to make flight or seat adjustments.
OPENA- The flight is open for check-in at the local departure airport only.
OPENAI- The flight is open for check-in at any of your airlines airport locations only.
OPENC- The flight is open for check-in and seat selection at any location. Automatic issuance of inter-city boarding pass from an upline location is disabled.
OPENCI- Normal check-in. The flight is open for check-in and seat selection at any location. Automatic issuance of an inter-city boarding pass from an upline location in enabled.
CANCEL- To inhibit further check-in on a flight which will not be able to operate.
RETURN- Provides the airline with the ability to change a flight status if the flight returns to the gate after final PDC.
FINAL- All seats will be returned with the exception of broken seat blocks.
PDC- The flight has been closed for check-in and has departed.
LOCKED- After repeated attempts to “CLOSE” a flight outside of load plan variance, the flight will be locked from further “CLOSE” attempts.
UNMECH- An old term for a flight status of a flight that originates or goes through a station that is not ACTIVE. Flight status shows a "U" on the flight detail.
HOLD- Same as “HELD”.
INACTIVE- Internal temporary status.
OTHER- Unmapped/Unknown ['CLOSED', 'HELD', 'OPENA', 'OPENAI', 'OPENC', 'OPENCI', 'CANCEL', 'RETURN', 'FINAL', 'PDC', 'LOCKED', 'UNMECH', 'HOLD', 'INACTIVE', 'OTHER'].
• Time - Flight List services will consider estimated time for arrival service and will return all times in 24-hour format. If in case we have scheduled time alone, system will pick scheduled time as the estimated Time. On other hand if we have estimated time updated, system will go with estimated time.
Start Time- Determine the start time range of what flights to return.
End Time- Determine the end time range of what flights to return.
• Date - You need to specify the date as it is a mandatory field.
Past Date- When a user based in BLR, retrieves the flight List for flights departing from ‘LHR’ for the past date (18JUN, start and end time is nil), the system will return flights for the complete day.
Current Date- When a user based in BLR, retrieves the flight list for flights departing from ‘LHR’ for the current date (19JUN, start and end time is nil), the system will return flights from the current local time at LHR for the current day.
Future Date- When a user based in BLR, retrieves the flight List for flights departing from ‘LHR’ for a future date (20JUN, start and end time is nil), the system will return flights for the complete day.
• Airport Code is again mandatory. User can retrieve all flights arriving into a specific city.