Skip to main content

Satcat SDK

The Satcat SDK is a Python client library for automating interactions with Satcat's spaceflight safety services. It allows users to fetch event data, upload and manage ephemerides, trigger catalog screenings, and manage operational state—all without needing to manually interact with the web interface.

It is suitable for operators integrating Satcat functionality into flight dynamics systems or building custom SSA automation pipelines.

View Full SDK Reference Docs →

Key Capabilities​

  • Fetch and filter conjunction events
  • Upload and manage ephemerides
  • Trigger catalog screenings and retrieve results
  • Manage ephemeris operational state
  • Initiate and retrieve propagation jobs
  • Access screening output from propagated or uploaded orbits

Satcat CLI​

The SDK includes satcat, a command-line interface (CLI) for power users. It supports common operations such as fetching CDMs, uploading ephemeris files, and initiating screenings directly from the terminal.

Use the CLI for rapid tasking or scripting without writing Python.

Installation​

The SDK is distributed on PyPI and can be installed with:

pip install satcat

API Keys​

API keys allow users to authenticate securely with Satcat Operations. Once generated, they can be used with the Satcat SDK or CLI for actions such as:

  • Uploading ephemeris
  • Launching screening jobs
  • Triggering maneuver generation
  • Accessing CDMs and analytics products

Creating an API Key​

  1. Navigate to ⚙️ Control Center > Personal > API Keys
  2. Click Generate New Key
  3. Assign a descriptive name for identification
  4. Copy the generated Client ID and Client Secret
caution

This is the only time the Client Secret will be displayed. Store it securely. If lost, you must regenerate the key.

Managing API Keys​

Use the [⋮] menu for additional actions:

  • Rename the API key
  • Regenerate the Client Secret
  • Delete the key from your organization
warning

Deleting an API key is permanent. All applications using that key will lose access immediately.

Resources and File Types​

  • Events: Access and filter conjunction events linked to your assets
  • Ephemerides: Upload, download, and designate ephemeris files as OPERATIONAL
  • Screenings: Run catalog screenings using uploaded or propagated ephemerides
  • Propagations: Submit OPMs for forward propagation and analysis

Supported file types:

  • CCSDS Orbit Parameter Messages (OPM)
  • OEMs for telemetry ingestion
  • CDM for conjunction reporting

Source and License​

The Satcat SDK is open source under the Apache 2.0 license.