at.adsb.flight.record

{
  "id": "at.adsb.flight.record",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "icaoHex",
          "firstSeen",
          "lastSeen",
          "contributors",
          "createdAt"
        ],
        "properties": {
          "track": {
            "type": "blob",
            "accept": [
              "application/json",
              "application/zstd"
            ],
            "maxSize": 2000000,
            "description": "Full position track as a JSON array of at.adsb.flight.defs#position objects, optionally compressed."
          },
          "origin": {
            "ref": "#airport",
            "type": "ref",
            "description": "Departure airport, if known."
          },
          "icaoHex": {
            "type": "string",
            "maxLength": 6,
            "minLength": 6,
            "description": "ICAO 24-bit aircraft address in hexadecimal (e.g. 'A1B2C3')."
          },
          "summary": {
            "ref": "at.adsb.flight.defs#trackSummary",
            "type": "ref",
            "description": "Summary of the flight path."
          },
          "callsign": {
            "type": "string",
            "maxLength": 8,
            "description": "Flight callsign as broadcast (e.g. 'UAL123')."
          },
          "lastSeen": {
            "type": "string",
            "format": "datetime",
            "description": "When the aircraft was last observed by any contributor."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "firstSeen": {
            "type": "string",
            "format": "datetime",
            "description": "When the aircraft was first observed by any contributor."
          },
          "destination": {
            "ref": "#airport",
            "type": "ref",
            "description": "Arrival airport, if known."
          },
          "aircraftType": {
            "type": "string",
            "maxLength": 4,
            "description": "ICAO type designator (e.g. 'B738', 'A320')."
          },
          "contributors": {
            "type": "array",
            "items": {
              "ref": "at.adsb.flight.defs#contributor",
              "type": "ref"
            },
            "maxLength": 100,
            "minLength": 1,
            "description": "Receivers that contributed data to this flight record."
          },
          "registration": {
            "type": "string",
            "maxLength": 10,
            "description": "Aircraft registration (e.g. 'N12345', 'C-GABC')."
          },
          "positionCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Total position reports across all contributors."
          }
        }
      },
      "description": "A completed flight record with receiver attribution."
    },
    "airport": {
      "type": "object",
      "properties": {
        "iata": {
          "type": "string",
          "maxLength": 3,
          "minLength": 3,
          "description": "IATA airport code (e.g. 'BOS', 'LHR')."
        },
        "icao": {
          "type": "string",
          "maxLength": 4,
          "minLength": 4,
          "description": "ICAO airport code (e.g. 'KBOS', 'EGLL')."
        },
        "name": {
          "type": "string",
          "maxLength": 1280,
          "description": "Human-readable airport name.",
          "maxGraphemes": 128
        },
        "location": {
          "ref": "community.lexicon.location.geo",
          "type": "ref",
          "description": "Geographic position of the airport."
        }
      },
      "description": "An airport identified by ICAO or IATA code."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "A completed flight as synthesised from one or more receiver sightings. Created by an aggregator after the flight is no longer tracked. Links back to the individual receiver sightings that contributed data."
}