Flight Planning

Plan flights, manage status and update delay information.

Flight Object

FeldTypPflichtBeschreibung
idintegerOptionalUnique flight ID
flight_numberstringPflichtICAO flight numberz.B. LH1234
originstringPflichtDeparture airport (IATA)z.B. FRA
destinationstringPflichtDestination airport (IATA)z.B. JFK
departure_utcdatetimePflichtScheduled departure time (UTC, ISO 8601)
arrival_utcdatetimePflichtScheduled arrival time (UTC, ISO 8601)
aircraft_idstringPflichtAircraft ID (registration)z.B. D-AIMK
statusenumOptionalscheduled | delayed | departed | arrived | cancelled | diverted
delay_minutesinteger|nullOptionalDelay in minutes
delay_reasonstring|nullOptionalIATA delay codez.B. 93 (ATC)
gatestring|nullOptionalGate numberz.B. B42
remarksstring|nullOptionalInternal remarks
created_atdatetimeOptionalCreation timestamp
updated_atdatetimeOptionalLast modified

Status Workflow

scheduled → departed → arrived
scheduled → delayed → departed → arrived
scheduled → cancelled
departed → diverted → arrived

GET /flights — List Flights

GEThttps://api.aeroselect.io/api/v1/aeroops/flights
FeldTypPflichtBeschreibung
datestringOptionalFilter by date (YYYY-MM-DD, UTC)
statusstringOptionalFilter by status
originstringOptionalFilter by departure airport (IATA)
destinationstringOptionalFilter by destination airport (IATA)
aircraft_idstringOptionalFilter by registration
cURLBash
curl "https://api.aeroselect.io/api/v1/aeroops/flights?date=2026-05-22&status=scheduled" \
  -H "X-API-Key: ak_live_YOUR_KEY"
Response 200JSON
{
  "data": [
    {
      "id": 5001,
      "flight_number": "LH1234",
      "origin": "FRA",
      "destination": "JFK",
      "departure_utc": "2026-05-22T06:00:00Z",
      "arrival_utc": "2026-05-22T14:45:00Z",
      "aircraft_id": "D-AIMK",
      "status": "scheduled",
      "delay_minutes": null,
      "delay_reason": null,
      "gate": "B42"
    }
  ],
  "meta": { "total": 14, "page": 1, "per_page": 25 }
}

POST /flights — Schedule Flight

POSThttps://api.aeroselect.io/api/v1/aeroops/flights
cURLBash
curl -X POST "https://api.aeroselect.io/api/v1/aeroops/flights" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "flight_number": "AE0815",
    "origin": "MUC",
    "destination": "DXB",
    "departure_utc": "2026-06-01T14:30:00Z",
    "arrival_utc": "2026-06-01T22:15:00Z",
    "aircraft_id": "D-AXYZ"
  }'

PATCH /flights/{id}/status — Update Status

PATCHhttps://api.aeroselect.io/api/v1/aeroops/flights/{id}/status
cURLBash
curl -X PATCH "https://api.aeroselect.io/api/v1/aeroops/flights/5001/status" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "delayed",
    "delay_minutes": 45,
    "delay_reason": "93"
  }'

IATA Delay Codes

AeroOps uses the standardized IATA delay codes. Commonly used codes: 11 (Late Aircraft), 14 (Boarding), 42 (Technical), 93 (ATC), 96 (Weather).

Node.js — Get daily flight schedule

daily-roster.jsJavaScript
const today = new Date().toISOString().slice(0, 10);

const response = await fetch(
  `https://api.aeroselect.io/api/v1/aeroops/flights?date=${today}`,
  { headers: { "X-API-Key": process.env.AEROSELECT_API_KEY } }
);
const { data: flights } = await response.json();

const delayed = flights.filter((f) => f.status === "delayed");
console.log(`${delayed.length} flights delayed today`);