Flight Summary Models

pydantic model flight_radar.models.flight_summary.FlightSummary

Bases: FlightSummaryLight

Show JSON schema
{
   "title": "FlightSummary",
   "type": "object",
   "properties": {
      "fr24_id": {
         "description": "Unique identifier assigned by Flightradar24 to the flight leg.",
         "title": "Fr24 Id",
         "type": "string"
      },
      "flight": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Commercial flight number.",
         "title": "Flight"
      },
      "callsign": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Callsign used by Air Traffic Control to denote\n        a specific flight (as sent by aircraft transponder).",
         "title": "Callsign"
      },
      "operating_as": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "ICAO code of the airline carrier as derived from flight callsign.",
         "title": "Operating As"
      },
      "painted_as": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "ICAO code of the carrier mapped from FR24's internal database.",
         "title": "Painted As"
      },
      "type": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft ICAO type code.",
         "title": "Type"
      },
      "reg": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft registration as matched from Mode-S identifier.",
         "title": "Reg"
      },
      "orig_icao": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Origin airport ICAO code.",
         "title": "Orig Icao"
      },
      "datetime_takeoff": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Datetime of takeoff in UTC",
         "title": "Datetime Takeoff"
      },
      "dest_icao": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Destination airport ICAO code.",
         "title": "Dest Icao"
      },
      "datetime_landed": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Datetime of landing in UTC",
         "title": "Datetime Landed"
      },
      "hex": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "24 bit Mode-S identifier expressed in hexadecimal format.",
         "title": "Hex"
      },
      "first_seen": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Datetime when the aircraft was first detected for this flight leg (UTC)",
         "title": "First Seen"
      },
      "last_seen": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Datetime when the aircraft was last detected for this flight leg (UTC)",
         "title": "Last Seen"
      },
      "flight_ended": {
         "anyOf": [
            {
               "type": "boolean"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flag indicating if the flight is live (currently tracked) or historical.",
         "title": "Flight Ended"
      },
      "orig_iata": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Origin airport IATA code.",
         "title": "Orig Iata"
      },
      "runway_takeoff": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Identifier of the runway used for takeoff.",
         "title": "Runway Takeoff"
      },
      "dest_iata": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Destination airport IATA code.",
         "title": "Dest Iata"
      },
      "dest_icao_actual": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "ICAO code for the actual destination airport (different when diverted).",
         "title": "Dest Icao Actual"
      },
      "dest_iata_actual": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "IATA code for the actual destination airport (different when diverted).",
         "title": "Dest Iata Actual"
      },
      "runway_landed": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Identifier of the runway used for landing.",
         "title": "Runway Landed"
      },
      "flight_time": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Duration of the flight from takeoff to landing in seconds.",
         "title": "Flight Time"
      },
      "actual_distance": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Actual ground distance the aircraft traveled (in km).",
         "title": "Actual Distance"
      },
      "circle_distance": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Great-circle distance between the first and last position (in km).",
         "title": "Circle Distance"
      }
   },
   "required": [
      "fr24_id"
   ]
}

Fields:
field actual_distance: float | None = None

Actual ground distance the aircraft traveled (in km).

field circle_distance: float | None = None

Great-circle distance between the first and last position (in km).

field dest_iata: str | None = None

Destination airport IATA code.

field dest_iata_actual: str | None = None

IATA code for the actual destination airport (different when diverted).

field dest_icao_actual: str | None = None

ICAO code for the actual destination airport (different when diverted).

field flight_time: float | None = None

Duration of the flight from takeoff to landing in seconds.

field orig_iata: str | None = None

Origin airport IATA code.

field runway_landed: str | None = None

Identifier of the runway used for landing.

field runway_takeoff: str | None = None

Identifier of the runway used for takeoff.

static from_dto(dto)
Return type:

FlightSummary

Parameters:

dto (FlightSummaryDto)

pydantic model flight_radar.models.flight_summary.FlightSummaryBaseRequest

Bases: BaseModel

Show JSON schema
{
   "title": "FlightSummaryBaseRequest",
   "type": "object",
   "properties": {
      "flight_ids": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "fr24_ids (maximum 15 IDs). Cannot be combined with flight_datetime",
         "title": "Flight Ids"
      },
      "flight_datetime_from": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight date lower range, uses first_seen.\n        Cannot be combined with flight_ids. The maximum permitted date range is 14 days.",
         "title": "Flight Datetime From"
      },
      "flight_datetime_to": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight date upper range, uses last_seen.\n        Cannot be combined with flight_ids. The maximum permitted date range is 14 days.",
         "title": "Flight Datetime To"
      },
      "flights": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight numbers (max 15).",
         "title": "Flights"
      },
      "callsigns": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight callsigns (max 15).",
         "title": "Callsigns"
      },
      "registrations": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft registration numbers (max 15).",
         "title": "Registrations"
      },
      "painted_as": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft painted in an airline's livery, identified by ICAO code,\n        but not necessarily operated by that airline, such as a regional airline operating a flight for a larger airline\n        (max 15).",
         "title": "Painted As"
      },
      "operating_as": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft operating under an airline's call sign, identified by ICAO code,\n        but not necessarily an aircraft belonging to that airline, such as an aircraft on lease from another airline\n        (max 15).",
         "title": "Operating As"
      },
      "airports": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/AirportWithDirection"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Airports (comma-separated values, max 15).",
         "title": "Airports"
      },
      "routes": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/Route"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flights between different airports or countries.\n        Airports specified by IATA or ICAO codes or countries specified by ISO 3166-1 alpha-2 codes (max 15).",
         "title": "Routes"
      },
      "aircraft": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft ICAO type codes (comma-separated values, max 15).",
         "title": "Aircraft"
      }
   },
   "$defs": {
      "AirportWithDirection": {
         "properties": {
            "airport": {
               "description": "Airport IATA or ICAO code.",
               "title": "Airport",
               "type": "string"
            },
            "direction": {
               "anyOf": [
                  {
                     "$ref": "#/$defs/Direction"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "Direction of the flight (inbound or outbound or both)."
            }
         },
         "required": [
            "airport"
         ],
         "title": "AirportWithDirection",
         "type": "object"
      },
      "Direction": {
         "enum": [
            "both",
            "inbound",
            "outbound"
         ],
         "title": "Direction",
         "type": "string"
      },
      "Route": {
         "properties": {
            "origin": {
               "description": "Origin airport IATA or ICAO code.",
               "title": "Origin",
               "type": "string"
            },
            "destination": {
               "description": "Destination airport IATA or ICAO code.",
               "title": "Destination",
               "type": "string"
            }
         },
         "required": [
            "origin",
            "destination"
         ],
         "title": "Route",
         "type": "object"
      }
   }
}

Fields:
Validators:
field aircraft: Optional[Annotated[List[str]]] = None

Aircraft ICAO type codes (comma-separated values, max 15).

Validated by:
field airports: Optional[Annotated[List[AirportWithDirection]]] = None

Airports (comma-separated values, max 15).

Validated by:
field callsigns: Optional[Annotated[List[str]]] = None

Flight callsigns (max 15).

Validated by:
field flight_datetime_from: datetime | None = None

Flight date lower range, uses first_seen. Cannot be combined with flight_ids. The maximum permitted date range is 14 days.

Validated by:
field flight_datetime_to: datetime | None = None

Flight date upper range, uses last_seen. Cannot be combined with flight_ids. The maximum permitted date range is 14 days.

Validated by:
field flight_ids: Optional[Annotated[List[str]]] = None

fr24_ids (maximum 15 IDs). Cannot be combined with flight_datetime

Validated by:
field flights: Optional[Annotated[List[str]]] = None

Flight numbers (max 15).

Validated by:
field operating_as: Optional[Annotated[List[str]]] = None

Aircraft operating under an airline’s call sign, identified by ICAO code, but not necessarily an aircraft belonging to that airline, such as an aircraft on lease from another airline (max 15).

Validated by:
field painted_as: Optional[Annotated[List[str]]] = None

Aircraft painted in an airline’s livery, identified by ICAO code, but not necessarily operated by that airline, such as a regional airline operating a flight for a larger airline (max 15).

Validated by:
field registrations: Optional[Annotated[List[str]]] = None

Aircraft registration numbers (max 15).

Validated by:
field routes: Optional[Annotated[List[Route]]] = None

Flights between different airports or countries. Airports specified by IATA or ICAO codes or countries specified by ISO 3166-1 alpha-2 codes (max 15).

Validated by:
to_dto()
Return type:

FlightSummaryBaseRequestDto

validator validate  »  all fields
pydantic model flight_radar.models.flight_summary.FlightSummaryCountRequest

Bases: FlightSummaryBaseRequest

Show JSON schema
{
   "title": "FlightSummaryCountRequest",
   "type": "object",
   "properties": {
      "flight_ids": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "fr24_ids (maximum 15 IDs). Cannot be combined with flight_datetime",
         "title": "Flight Ids"
      },
      "flight_datetime_from": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight date lower range, uses first_seen.\n        Cannot be combined with flight_ids. The maximum permitted date range is 14 days.",
         "title": "Flight Datetime From"
      },
      "flight_datetime_to": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight date upper range, uses last_seen.\n        Cannot be combined with flight_ids. The maximum permitted date range is 14 days.",
         "title": "Flight Datetime To"
      },
      "flights": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight numbers (max 15).",
         "title": "Flights"
      },
      "callsigns": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight callsigns (max 15).",
         "title": "Callsigns"
      },
      "registrations": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft registration numbers (max 15).",
         "title": "Registrations"
      },
      "painted_as": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft painted in an airline's livery, identified by ICAO code,\n        but not necessarily operated by that airline, such as a regional airline operating a flight for a larger airline\n        (max 15).",
         "title": "Painted As"
      },
      "operating_as": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft operating under an airline's call sign, identified by ICAO code,\n        but not necessarily an aircraft belonging to that airline, such as an aircraft on lease from another airline\n        (max 15).",
         "title": "Operating As"
      },
      "airports": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/AirportWithDirection"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Airports (comma-separated values, max 15).",
         "title": "Airports"
      },
      "routes": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/Route"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flights between different airports or countries.\n        Airports specified by IATA or ICAO codes or countries specified by ISO 3166-1 alpha-2 codes (max 15).",
         "title": "Routes"
      },
      "aircraft": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft ICAO type codes (comma-separated values, max 15).",
         "title": "Aircraft"
      }
   },
   "$defs": {
      "AirportWithDirection": {
         "properties": {
            "airport": {
               "description": "Airport IATA or ICAO code.",
               "title": "Airport",
               "type": "string"
            },
            "direction": {
               "anyOf": [
                  {
                     "$ref": "#/$defs/Direction"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "Direction of the flight (inbound or outbound or both)."
            }
         },
         "required": [
            "airport"
         ],
         "title": "AirportWithDirection",
         "type": "object"
      },
      "Direction": {
         "enum": [
            "both",
            "inbound",
            "outbound"
         ],
         "title": "Direction",
         "type": "string"
      },
      "Route": {
         "properties": {
            "origin": {
               "description": "Origin airport IATA or ICAO code.",
               "title": "Origin",
               "type": "string"
            },
            "destination": {
               "description": "Destination airport IATA or ICAO code.",
               "title": "Destination",
               "type": "string"
            }
         },
         "required": [
            "origin",
            "destination"
         ],
         "title": "Route",
         "type": "object"
      }
   }
}

Fields:

Validators:

pydantic model flight_radar.models.flight_summary.FlightSummaryLight

Bases: BaseModel

Show JSON schema
{
   "title": "FlightSummaryLight",
   "type": "object",
   "properties": {
      "fr24_id": {
         "description": "Unique identifier assigned by Flightradar24 to the flight leg.",
         "title": "Fr24 Id",
         "type": "string"
      },
      "flight": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Commercial flight number.",
         "title": "Flight"
      },
      "callsign": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Callsign used by Air Traffic Control to denote\n        a specific flight (as sent by aircraft transponder).",
         "title": "Callsign"
      },
      "operating_as": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "ICAO code of the airline carrier as derived from flight callsign.",
         "title": "Operating As"
      },
      "painted_as": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "ICAO code of the carrier mapped from FR24's internal database.",
         "title": "Painted As"
      },
      "type": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft ICAO type code.",
         "title": "Type"
      },
      "reg": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft registration as matched from Mode-S identifier.",
         "title": "Reg"
      },
      "orig_icao": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Origin airport ICAO code.",
         "title": "Orig Icao"
      },
      "datetime_takeoff": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Datetime of takeoff in UTC",
         "title": "Datetime Takeoff"
      },
      "dest_icao": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Destination airport ICAO code.",
         "title": "Dest Icao"
      },
      "datetime_landed": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Datetime of landing in UTC",
         "title": "Datetime Landed"
      },
      "hex": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "24 bit Mode-S identifier expressed in hexadecimal format.",
         "title": "Hex"
      },
      "first_seen": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Datetime when the aircraft was first detected for this flight leg (UTC)",
         "title": "First Seen"
      },
      "last_seen": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Datetime when the aircraft was last detected for this flight leg (UTC)",
         "title": "Last Seen"
      },
      "flight_ended": {
         "anyOf": [
            {
               "type": "boolean"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flag indicating if the flight is live (currently tracked) or historical.",
         "title": "Flight Ended"
      }
   },
   "required": [
      "fr24_id"
   ]
}

Fields:
field callsign: str | None = None

Callsign used by Air Traffic Control to denote a specific flight (as sent by aircraft transponder).

field datetime_landed: datetime | None = None

Datetime of landing in UTC

field datetime_takeoff: datetime | None = None

Datetime of takeoff in UTC

field dest_icao: str | None = None

Destination airport ICAO code.

field first_seen: datetime | None = None

Datetime when the aircraft was first detected for this flight leg (UTC)

field flight: str | None = None

Commercial flight number.

field flight_ended: bool | None = None

Flag indicating if the flight is live (currently tracked) or historical.

field fr24_id: str [Required]

Unique identifier assigned by Flightradar24 to the flight leg.

field hex: str | None = None

24 bit Mode-S identifier expressed in hexadecimal format.

field last_seen: datetime | None = None

Datetime when the aircraft was last detected for this flight leg (UTC)

field operating_as: str | None = None

ICAO code of the airline carrier as derived from flight callsign.

field orig_icao: str | None = None

Origin airport ICAO code.

field painted_as: str | None = None

ICAO code of the carrier mapped from FR24’s internal database.

field reg: str | None = None

Aircraft registration as matched from Mode-S identifier.

field type: str | None = None

Aircraft ICAO type code.

static from_dto(dto)
Return type:

FlightSummaryLight

Parameters:

dto (FlightSummaryLightDto)

pydantic model flight_radar.models.flight_summary.FlightSummaryRequest

Bases: FlightSummaryBaseRequest

Show JSON schema
{
   "title": "FlightSummaryRequest",
   "type": "object",
   "properties": {
      "flight_ids": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "fr24_ids (maximum 15 IDs). Cannot be combined with flight_datetime",
         "title": "Flight Ids"
      },
      "flight_datetime_from": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight date lower range, uses first_seen.\n        Cannot be combined with flight_ids. The maximum permitted date range is 14 days.",
         "title": "Flight Datetime From"
      },
      "flight_datetime_to": {
         "anyOf": [
            {
               "format": "date-time",
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight date upper range, uses last_seen.\n        Cannot be combined with flight_ids. The maximum permitted date range is 14 days.",
         "title": "Flight Datetime To"
      },
      "flights": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight numbers (max 15).",
         "title": "Flights"
      },
      "callsigns": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flight callsigns (max 15).",
         "title": "Callsigns"
      },
      "registrations": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft registration numbers (max 15).",
         "title": "Registrations"
      },
      "painted_as": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft painted in an airline's livery, identified by ICAO code,\n        but not necessarily operated by that airline, such as a regional airline operating a flight for a larger airline\n        (max 15).",
         "title": "Painted As"
      },
      "operating_as": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft operating under an airline's call sign, identified by ICAO code,\n        but not necessarily an aircraft belonging to that airline, such as an aircraft on lease from another airline\n        (max 15).",
         "title": "Operating As"
      },
      "airports": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/AirportWithDirection"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Airports (comma-separated values, max 15).",
         "title": "Airports"
      },
      "routes": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/Route"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Flights between different airports or countries.\n        Airports specified by IATA or ICAO codes or countries specified by ISO 3166-1 alpha-2 codes (max 15).",
         "title": "Routes"
      },
      "aircraft": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "maxItems": 15,
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Aircraft ICAO type codes (comma-separated values, max 15).",
         "title": "Aircraft"
      },
      "limit": {
         "anyOf": [
            {
               "maximum": 20000,
               "minimum": 1,
               "type": "integer"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Limit of results. Max value 20000",
         "title": "Limit"
      },
      "sort": {
         "anyOf": [
            {
               "$ref": "#/$defs/Sort"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Sorting order of the results by first_seen.\n        Default: asc (ascending). Available options: asc, desc."
      }
   },
   "$defs": {
      "AirportWithDirection": {
         "properties": {
            "airport": {
               "description": "Airport IATA or ICAO code.",
               "title": "Airport",
               "type": "string"
            },
            "direction": {
               "anyOf": [
                  {
                     "$ref": "#/$defs/Direction"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "description": "Direction of the flight (inbound or outbound or both)."
            }
         },
         "required": [
            "airport"
         ],
         "title": "AirportWithDirection",
         "type": "object"
      },
      "Direction": {
         "enum": [
            "both",
            "inbound",
            "outbound"
         ],
         "title": "Direction",
         "type": "string"
      },
      "Route": {
         "properties": {
            "origin": {
               "description": "Origin airport IATA or ICAO code.",
               "title": "Origin",
               "type": "string"
            },
            "destination": {
               "description": "Destination airport IATA or ICAO code.",
               "title": "Destination",
               "type": "string"
            }
         },
         "required": [
            "origin",
            "destination"
         ],
         "title": "Route",
         "type": "object"
      },
      "Sort": {
         "enum": [
            "asc",
            "desc"
         ],
         "title": "Sort",
         "type": "string"
      }
   }
}

Fields:
Validators:

field limit: Optional[Annotated[int]] = None

Limit of results. Max value 20000

Validated by:
field sort: Sort | None = None

Sorting order of the results by first_seen. Default: asc (ascending). Available options: asc, desc.

Validated by:
to_dto()
Return type:

GetFlightSummaryRequestDto

class flight_radar.models.flight_summary.FlightSummaryBaseRequest(**data)
Parameters:
  • flight_ids (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • flight_datetime_from (datetime | None)

  • flight_datetime_to (datetime | None)

  • flights (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • callsigns (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • registrations (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • painted_as (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • operating_as (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • airports (Annotated[List[AirportWithDirection], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • routes (Annotated[List[Route], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • aircraft (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

model_config: ClassVar[ConfigDict] = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class flight_radar.models.flight_summary.FlightSummaryRequest(**data)
Parameters:
  • flight_ids (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • flight_datetime_from (datetime | None)

  • flight_datetime_to (datetime | None)

  • flights (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • callsigns (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • registrations (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • painted_as (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • operating_as (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • airports (Annotated[List[AirportWithDirection], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • routes (Annotated[List[Route], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • aircraft (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • limit (Annotated[int, FieldInfo(annotation=NoneType, required=True, metadata=[Ge(ge=1), Le(le=20000)])] | None)

  • sort (Sort | None)

model_config: ClassVar[ConfigDict] = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class flight_radar.models.flight_summary.FlightSummaryCountRequest(**data)
Parameters:
  • flight_ids (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • flight_datetime_from (datetime | None)

  • flight_datetime_to (datetime | None)

  • flights (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • callsigns (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • registrations (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • painted_as (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • operating_as (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • airports (Annotated[List[AirportWithDirection], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • routes (Annotated[List[Route], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

  • aircraft (Annotated[List[str], FieldInfo(annotation=NoneType, required=True, metadata=[MaxLen(max_length=15)])] | None)

model_config: ClassVar[ConfigDict] = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class flight_radar.models.flight_summary.FlightSummaryLight(**data)
Parameters:
  • fr24_id (str)

  • flight (str | None)

  • callsign (str | None)

  • operating_as (str | None)

  • painted_as (str | None)

  • type (str | None)

  • reg (str | None)

  • orig_icao (str | None)

  • datetime_takeoff (datetime | None)

  • dest_icao (str | None)

  • datetime_landed (datetime | None)

  • hex (str | None)

  • first_seen (datetime | None)

  • last_seen (datetime | None)

  • flight_ended (bool | None)

model_config: ClassVar[ConfigDict] = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class flight_radar.models.flight_summary.FlightSummary(**data)
Parameters:
  • fr24_id (str)

  • flight (str | None)

  • callsign (str | None)

  • operating_as (str | None)

  • painted_as (str | None)

  • type (str | None)

  • reg (str | None)

  • orig_icao (str | None)

  • datetime_takeoff (datetime | None)

  • dest_icao (str | None)

  • datetime_landed (datetime | None)

  • hex (str | None)

  • first_seen (datetime | None)

  • last_seen (datetime | None)

  • flight_ended (bool | None)

  • orig_iata (str | None)

  • runway_takeoff (str | None)

  • dest_iata (str | None)

  • dest_icao_actual (str | None)

  • dest_iata_actual (str | None)

  • runway_landed (str | None)

  • flight_time (float | None)

  • actual_distance (float | None)

  • circle_distance (float | None)

model_config: ClassVar[ConfigDict] = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].