Skip to main content

Objects

An object represents a satellite in orbit.

Objects have the following properties:

  • A human-readable name.
  • (optional) NORAD ID, for cross-referencing with other catalogs.
  • Maneuverability status (true or false)
  • Hard-body radius, measured in meters, used for calculating probability of collision.

A NORAD ID is useful for cross-referencing with the space-track.org catalog. Prior to launch, operators may coordinate with the US Space Force to acquire a "UCN ID" (9-digit number starting with 799...). In these cases, that number may be used in early mission, otherwise, you may keep it as NULL.

Once the item is assigned a permanent NORAD ID, it can but updated with the PUT /api/v1/object API. If you have a space-track.org account and would like us to automatically sync your object information from there, let us know.

Operators authenticated with a key with the object:manage permission can use the POST /api/v1/object and PUT /api/v1/object endpoints to create new objects associated with their account, or update the properties of their existing objects respectively.