Usage

Connection

The following curl command connects to the Flights Live endpoint, retrieves real-time in UTC for the specified ICAO address and prints the received data to the console.

curl -H "Authorization: Bearer <your_token>" "https://api.airsafe.spire.com/v2/flights/live?icao_address=896497"

Query Parameters

The following parameters can be specified to retrieve real-time data with more accuracy.

Query Parameters	Type	Description
flight_id	ID	Spire internal unique flight ID
icao_address	string	Hexadecimal representation of ICAO 24 – bit address
callsign	string	Call sign
flight_number	string	Flight number (IATA format)
tail_number	string	Aircraft registration
aircraft_type	string	IATA/ICAO aircraft type code
aircraft_role	string	Aircraft role e.g. PAX
airline	string	IATA/ICAO airline code
departure_airport	string	IATA/ICAO departure airport code
arrival_airport	string	IATA/ICAO arrival airport code
operating_airport	string	IATA/ICAO airport code for all inbound and outbound flights
flight_state	string	Flight state as one of "ON_GROUND","AIRBORNE","LANDED","POST_FLIGHT"