hubvibe-io.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "The 200 body of every paid /work call. `result` is the worker's own output (its schema is per route); everything else is the same on every /work route. A receipt for the job is at `receipt_url`.",
  "properties": {
    "attribution": {
      "$ref": "#/components/schemas/Attribution"
    },
    "billing_warning": {
      "description": "Present only when the charge was recorded with a caveat.",
      "examples": [
        "settlement pending"
      ],
      "type": "string"
    },
    "price_usd": {
      "description": "What this call cost, in USD.",
      "examples": [
        0.02
      ],
      "type": "number"
    },
    "provenance": {
      "$ref": "#/components/schemas/Provenance"
    },
    "receipt_id": {
      "description": "Receipt id for this job.",
      "examples": [
        "rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "receipt_url": {
      "description": "Where to fetch the machine-readable receipt (free, no payment).",
      "examples": [
        "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
      ],
      "type": "string"
    },
    "result": {
      "properties": {
        "aircraft": {
          "description": "Aircraft, nearest first.",
          "examples": [
            []
          ],
          "items": {
            "description": "An aircraft (adsb.lol, ODbL).",
            "properties": {
              "altitude_ft": {
                "description": "Barometric altitude.",
                "examples": [
                  36975
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "callsign": {
                "description": "Callsign.",
                "examples": [
                  "SAS51D"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "distance_km": {
                "description": "Distance from the airport.",
                "examples": [
                  12.4
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "ground_speed_kt": {
                "description": "Ground speed.",
                "examples": [
                  486.8
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "hex": {
                "description": "ICAO 24-bit address.",
                "examples": [
                  "4cac79"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "lat": {
                "description": "Latitude.",
                "examples": [
                  59.561
                ],
                "type": "number"
              },
              "lon": {
                "description": "Longitude.",
                "examples": [
                  10.538
                ],
                "type": "number"
              },
              "on_ground": {
                "description": "On the ground.",
                "examples": [
                  false
                ],
                "type": "boolean"
              },
              "registration": {
                "description": "Registration.",
                "examples": [
                  "EI-SIJ"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "squawk": {
                "description": "Squawk.",
                "examples": [
                  "6220"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "track_deg": {
                "description": "Track.",
                "examples": [
                  76.8
                ],
                "type": [
                  "number",
                  "null"
                ]
              },
              "type": {
                "description": "Aircraft type.",
                "examples": [
                  "A20N"
                ],
                "type": [
                  "string",
                  "null"
                ]
              },
              "vertical_rate_fpm": {
                "description": "Climb/descent rate.",
                "examples": [
                  0
                ],
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "callsign",
              "hex",
              "registration",
              "type",
              "lat",
              "lon",
              "altitude_ft",
              "on_ground",
              "ground_speed_kt",
              "track_deg",
              "vertical_rate_fpm",
              "squawk",
              "distance_km"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "aircraft_scope": {
          "description": "What the aircraft list covers.",
          "examples": [
            "within 25 nautical miles"
          ],
          "type": [
            "string",
            "null"
          ]
        },
        "airport": {
          "description": "The airport (OurAirports, public domain); null for a callsign-only query.",
          "properties": {
            "city": {
              "description": "City.",
              "examples": [
                "Oslo (Gardermoen)"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "country": {
              "description": "ISO country.",
              "examples": [
                "NO"
              ],
              "type": "string"
            },
            "iata": {
              "description": "IATA code.",
              "examples": [
                "OSL"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "icao": {
              "description": "ICAO code.",
              "examples": [
                "ENGM"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "lat": {
              "description": "Latitude.",
              "examples": [
                60.1939
              ],
              "type": "number"
            },
            "lon": {
              "description": "Longitude.",
              "examples": [
                11.1004
              ],
              "type": "number"
            },
            "name": {
              "description": "Airport.",
              "examples": [
                "Oslo-Gardermoen International Airport"
              ],
              "type": "string"
            }
          },
          "required": [
            "iata",
            "icao",
            "name",
            "city",
            "country",
            "lat",
            "lon"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "attribution": {
          "description": "Credits to show with the data.",
          "examples": [
            []
          ],
          "items": {
            "description": "A required credit.",
            "properties": {
              "text": {
                "description": "Credit.",
                "examples": [
                  "Flight data from Avinor"
                ],
                "type": "string"
              },
              "url": {
                "description": "Link.",
                "examples": [
                  "https://www.avinor.no"
                ],
                "type": "string"
              }
            },
            "required": [
              "text",
              "url"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "board": {
          "description": "Live board (Norway, Avinor); null elsewhere.",
          "properties": {
            "arrivals": {
              "description": "Arrivals, by scheduled time.",
              "examples": [
                []
              ],
              "items": {
                "$ref": "#/components/schemas/DeparturesItem"
              },
              "type": "array"
            },
            "attribution": {
              "description": "Required credit.",
              "examples": [
                "Flight data from Avinor"
              ],
              "type": "string"
            },
            "attribution_url": {
              "description": "Credit link.",
              "examples": [
                "https://www.avinor.no"
              ],
              "type": "string"
            },
            "departures": {
              "description": "Departures, by scheduled time.",
              "examples": [
                []
              ],
              "items": {
                "$ref": "#/components/schemas/DeparturesItem"
              },
              "type": "array"
            },
            "last_update": {
              "description": "When Avinor last updated the board.",
              "examples": [
                "2026-09-28T12:29:26.891757Z"
              ],
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "departures",
            "arrivals",
            "last_update",
            "attribution",
            "attribution_url"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "checked_at": {
          "description": "When this node read the source (UTC). Nothing here is cached.",
          "examples": [
            "2026-09-26T18:00:00Z"
          ],
          "format": "date-time",
          "type": "string"
        },
        "coverage": {
          "description": "Which sources cover this query.",
          "properties": {
            "aircraft": {
              "description": "Live positions.",
              "examples": [
                true
              ],
              "type": "boolean"
            },
            "board": {
              "description": "Avinor covers it.",
              "examples": [
                true
              ],
              "type": "boolean"
            },
            "delays": {
              "description": "FAA covers this airport.",
              "examples": [
                false
              ],
              "type": "boolean"
            },
            "weather": {
              "description": "A METAR station exists.",
              "examples": [
                true
              ],
              "type": "boolean"
            }
          },
          "required": [
            "delays",
            "board",
            "weather",
            "aircraft"
          ],
          "type": "object"
        },
        "delays": {
          "description": "FAA National Airspace System status (US airports); null elsewhere.",
          "properties": {
            "arrival_delay": {
              "description": "Arrival delays.",
              "examples": [
                null
              ],
              "type": [
                "object",
                "null"
              ]
            },
            "closure": {
              "description": "Closure notice.",
              "examples": [
                null
              ],
              "type": [
                "object",
                "null"
              ]
            },
            "deicing": {
              "description": "De-icing in progress.",
              "examples": [
                false
              ],
              "type": "boolean"
            },
            "departure_delay": {
              "description": "Departure delays.",
              "examples": [
                null
              ],
              "type": [
                "object",
                "null"
              ]
            },
            "ground_delay": {
              "description": "Ground delay program: reason, from, until, avg_minutes, max_minutes.",
              "examples": [
                {
                  "avg_minutes": 44,
                  "from": "2026-09-28T15:00:00Z",
                  "max_minutes": 120,
                  "reason": "low ceilings",
                  "until": "2026-09-28T23:29:00Z"
                }
              ],
              "type": [
                "object",
                "null"
              ]
            },
            "ground_stop": {
              "description": "Ground stop in force.",
              "examples": [
                null
              ],
              "type": [
                "object",
                "null"
              ]
            },
            "notices": {
              "description": "Free-form FAA notices.",
              "examples": [
                []
              ],
              "items": {
                "description": "A notice.",
                "examples": [
                  "!SFO 09/165 ..."
                ],
                "type": "string"
              },
              "type": "array"
            },
            "runways": {
              "description": "Runway configuration; null when not published.",
              "properties": {
                "arrival": {
                  "description": "Arrival runways.",
                  "examples": [
                    "28L/28R"
                  ],
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "arrival_rate_per_hour": {
                  "description": "Arrival rate.",
                  "examples": [
                    30
                  ],
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "departure": {
                  "description": "Departure runways.",
                  "examples": [
                    "28L/28R"
                  ],
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "arrival",
                "departure",
                "arrival_rate_per_hour"
              ],
              "type": [
                "object",
                "null"
              ]
            },
            "source": {
              "description": "Source.",
              "examples": [
                "FAA NAS Status"
              ],
              "type": "string"
            },
            "status": {
              "description": "Overall FAA status.",
              "enum": [
                "normal",
                "delays",
                "ground_delay",
                "ground_stop",
                "closed"
              ],
              "examples": [
                "ground_delay"
              ],
              "type": "string"
            }
          },
          "required": [
            "status",
            "ground_stop",
            "ground_delay",
            "closure",
            "arrival_delay",
            "departure_delay",
            "deicing",
            "runways",
            "notices",
            "source"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "notes": {
          "description": "Caveats; empty when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "A caveat.",
            "examples": [
              "Live boards cover Norway."
            ],
            "type": "string"
          },
          "type": "array"
        },
        "query": {
          "description": "What was asked.",
          "properties": {
            "airport": {
              "description": "Airport code sent.",
              "examples": [
                "OSL"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "callsign": {
              "description": "Callsign sent.",
              "examples": [
                "SAS51D"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "direction": {
              "description": "Board direction.",
              "enum": [
                "both",
                "departures",
                "arrivals"
              ],
              "examples": [
                "both"
              ],
              "type": "string"
            },
            "flight": {
              "description": "Flight filter.",
              "examples": [
                "SK344"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "hours_ahead": {
              "description": "Board window ahead, hours.",
              "examples": [
                3
              ],
              "type": "integer"
            }
          },
          "required": [
            "airport",
            "callsign",
            "flight",
            "direction",
            "hours_ahead"
          ],
          "type": "object"
        },
        "sections_failed": {
          "description": "Empty when none.",
          "examples": [
            []
          ],
          "items": {
            "description": "A section whose source did not answer.",
            "examples": [
              "aircraft"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "weather": {
          "description": "Airport weather; null without a METAR.",
          "properties": {
            "dewpoint_c": {
              "description": "Dew point.",
              "examples": [
                12
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "flight_category": {
              "description": "VFR, MVFR, IFR or LIFR.",
              "examples": [
                "MVFR"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "gust_kt": {
              "description": "Gusts.",
              "examples": [
                24
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "metar": {
              "description": "Raw METAR.",
              "examples": [
                "METAR ENGM 281220Z 17008KT 9999 -RA BKN012 14/12 Q1017"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "observed_at": {
              "description": "Report time.",
              "examples": [
                "2026-09-28T12:20:00.000Z"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "source": {
              "description": "Source.",
              "examples": [
                "NOAA Aviation Weather Center"
              ],
              "type": "string"
            },
            "taf": {
              "description": "Raw TAF.",
              "examples": [
                "TAF ENGM 281100Z 2812/2912 ..."
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "temperature_c": {
              "description": "Temperature.",
              "examples": [
                14
              ],
              "type": [
                "number",
                "null"
              ]
            },
            "visibility": {
              "description": "Visibility as reported.",
              "examples": [
                "6+"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "weather": {
              "description": "Present weather.",
              "examples": [
                "-RA"
              ],
              "type": [
                "string",
                "null"
              ]
            },
            "wind_dir_deg": {
              "description": "Wind direction (VRB when variable).",
              "examples": [
                170
              ],
              "type": [
                "number",
                "string",
                "null"
              ]
            },
            "wind_kt": {
              "description": "Wind speed.",
              "examples": [
                8
              ],
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "metar",
            "taf",
            "flight_category",
            "temperature_c",
            "dewpoint_c",
            "wind_dir_deg",
            "wind_kt",
            "gust_kt",
            "visibility",
            "weather",
            "observed_at",
            "source"
          ],
          "type": [
            "object",
            "null"
          ]
        }
      },
      "required": [
        "query",
        "airport",
        "delays",
        "board",
        "weather",
        "aircraft",
        "aircraft_scope",
        "coverage",
        "attribution",
        "sections_failed",
        "notes",
        "checked_at"
      ],
      "type": "object"
    },
    "status": {
      "const": "ok",
      "description": "Present only on a delivered result.",
      "type": "string"
    },
    "worker": {
      "description": "Catalog name of the worker that ran.",
      "examples": [
        "market.quote"
      ],
      "type": "string"
    }
  },
  "required": [
    "status",
    "worker",
    "price_usd",
    "result",
    "provenance",
    "receipt_id",
    "receipt_url"
  ],
  "title": "travel.flight_status response",
  "type": "object"
}