query_gcat_satcat
Retrieve satellite records from the GCAT/SATCAT catalog using chainable filters for name, object type, owner, status, and orbital elements.
Instructions
Query GCAT SATCAT with advanced chainable filters.
At least one filter parameter must be provided. Filters are applied sequentially to narrow results. Use list_gcat_options() to see valid enumeration codes for object_type, status, etc.
Args: name: Name substring search (case-insensitive). object_type: Object type prefix — P=Payload, R1-R4=Rocket stages, D=Debris, C=Craft. Use list_gcat_options() for full codes. owner: Owner/operator organization code (e.g. "NASA", "SpX"). state: State/country code (e.g. "US", "CN", "JP", "SU"). status: Orbital status code — O=In orbit, R=Reentered, D=Deorbited, E=Escaped, C=Non-functional. Use list_gcat_options() for full codes. perigee_min: Minimum perigee altitude in km. perigee_max: Maximum perigee altitude in km. apogee_min: Minimum apogee altitude in km. apogee_max: Maximum apogee altitude in km. inc_min: Minimum inclination in degrees. inc_max: Maximum inclination in degrees. limit: Maximum number of records to return (default 100).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| limit | No | ||
| owner | No | ||
| state | No | ||
| status | No | ||
| inc_max | No | ||
| inc_min | No | ||
| apogee_max | No | ||
| apogee_min | No | ||
| object_type | No | ||
| perigee_max | No | ||
| perigee_min | No |