POST/data/snapshot

Get Snapshot

Generate a time-windowed operational snapshot for simulation.

POST/data/snapshotAUTH

Generate an operational snapshot combining flights, maintenance, crew, and tails.

Creates a time-windowed snapshot of the airline's operational state. This combines flight schedules, maintenance events, crew pairings, and aircraft tail data into a flat structure optimised for the simulation engine.

When a disrupted_flight_date is provided, the snapshot window starts at that timestamp and extends 48 hours forward.

Request Body

Parameter	Type	Required	Description
`airline`	string	Required	Airline code.
`force_refresh`	boolean= false	Optional	Bypass the 5-minute cache.
`disrupted_flight_date`	string	Optional	ISO 8601 datetime that anchors the 48-hour snapshot window (e.g. `"2026-04-07T08:30:00Z"`).

Example Request

json

{
  "airline": "QF",
  "disrupted_flight_date": "2026-04-07T08:30:00Z"
}

Response

json

{
  "flights": [
    {
      "id": "QF401_2026-04-07T08:30:00Z",
      "tail": "VH-OQA",
      "origin": "SYD",
      "dest": "MEL",
      "dep": "2026-04-07T08:30:00Z",
      "arr": "2026-04-07T10:00:00Z",
      "crew_pair": "CP_001",
      "total_pax": 154,
      "capacity": 176,
      "aircraft_type": "B738",
      "status": "scheduled"
    }
  ],
  "maintenance": [
    {
      "tail": "VH-OQA",
      "start": "2026-04-08T22:00:00Z",
      "end": "2026-04-09T06:00:00Z",
      "station": "SYD",
      "type": "scheduled"
    }
  ],
  "crew_pairs": [
    { "id": "CP_001", "base": "SYD" }
  ],
  "tails": [
    {
      "id": "VH-OQA",
      "aircraft_type": "B738",
      "initial_location": "SYD"
    }
  ],
  "metadata": {
    "source": "navblue_operational_api:airline:QF",
    "airline": "QF",
    "generated_at": "2026-04-07T12:00:00+00:00",
    "flight_count": 142,
    "maintenance_count": 3,
    "crew_pair_count": 38,
    "tail_count": 24,
    "snapshot_window": {
      "start": "2026-04-07T08:30:00Z",
      "end": "2026-04-09T08:30:00Z"
    }
  }
}

Snapshot Window

The metadata.snapshot_window object indicates the time range covered:

snapshot_window.startstring

Start of the window (ISO 8601). Matches the disrupted_flight_date if provided.

snapshot_window.endstring

End of the window — always 48 hours after start.

Date format

The disrupted_flight_date must be a valid ISO 8601 datetime. Accepted formats include 2026-04-07T08:30:00Z and 2026-04-07T08:30:00+00:00. Invalid formats return a 400 error.