empyrean.query_observations

query_observations(designations, cache_dir=None)

Fetch ADES observation records from the MPC for one or more designations.

Returns the full ADES schema parsed into a quivr ADESObservations table — every column the MPC API populates round-trips losslessly.

Parameters:

• designations (Sequence[str]) – MPC designations (e.g. "99942", "2024 YR4", "67P").

• cache_dir (str | Path | bool | None) –

  • None (default): cache JSON responses under $EMPYREAN_CACHE_DIR/mpc (or ~/.empyrean/cache/mpc).

  • False: disable caching for this call.

  • explicit path: use this directory.

Return type:

ADESObservations