skytracker.services.state.search_state#

async skytracker.services.state.search_state(storage: Storage, limit: int = 0, callsign: str | None = None, status: Literal['UNKNOWN', 'STARTED', 'LANDED', 'EN_ROUTE'] | None = None, model: str | None = None, registration: str | None = None, airline: str | None = None, arrival: str | None = None, departure: str | None = None, on_ground: bool | None = None, squawk: str | None = None) → list[State]#

Search for a state given specific information

Parameters:

  • storage (Storage) – backend storage manager

  • limit (int, optional) – maximum number of states to retrieve (0=all). Defaults to 0 (all).

  • callsign (str | None, optional) – aircraft callsign (ICAO). Defaults to None.

  • status (Literal['UNKNOWN', 'STARTED', 'LANDED', 'EN_ROUTE'] | None, optional) – aircraft status. Defaults to None.

  • model (str | None, optional) – aircraft model IATA code (4 characters). Defaults to None.

  • registration (str | None, optional) – aircraft registration (tail number). Defaults to None.

  • airline (str | None, optional) – airline IATA code (2 characters). Defaults to None.

  • arrival (str | None, optional) – arrival airport IATA code (3 characters). Defaults to None.

  • departure (str | None, optional) – departure airport IATA code (3 characters). Defaults to None.

  • on_ground (bool | None, optional) – whether aircraft is on ground. Defaults to None.

  • squawk (str | None, optional) – transponder squawk code. Defaults to None.

Returns:

state search results

Return type:

list[State]