Skip to main content
Change a flight’s operational status. The endpoint automatically stamps ActualDepartureTime when switching to departed/in_flight and ActualArrivalTime when switching to landed/arrived if not explicitly supplied.

​
Request

​
Parameters

​
string
required
The FlightId or FlightNumber of the flight.
​
string
required
Target flight status. Must be one of:
  • scheduled: Flight is on schedule
  • boarding: Passengers are boarding
  • gate_closed: Boarding closed, preparing for pushback
  • departed: Flight has pushed back / departed
  • in_flight: Aircraft is airborne
  • landed: Aircraft has touched down
  • arrived: Flight reached destination gate
  • delayed: Flight is experiencing delay
  • cancelled: Flight has been cancelled
​
integer
Optional delay duration in minutes.
​
string
Optional delay reason description.
​
string
Optional custom actual departure timestamp (ISO 8601).
​
string
Optional custom actual arrival timestamp (ISO 8601).
​
string
Optional display note or gate announcement text.

​
Response

​

​
Status Codes

  • 200: Flight status updated successfully
  • 400: Invalid status value
  • 401: API key is required
  • 404: Flight not found