Data Access API

Overview

The SCORE API provides programmatic access to satellite observation data, allowing you to retrieve observations through a RESTful interface. The API is rate-limited to 10 requests per second.

Full API Documentation

The full OpenAPI documentation is available at https://score.cps.iau.org/api/docs.

Base URL

https://score.cps.iau.org/api

Available Endpoints

Endpoint Description Parameters
/observation/{id} Get details for a specific observation observation_id (int)
/observations List all observations (paginated) offset, limit
/satellite/{number}/observations Get observations for a specific satellite satellite_number (NORAD ID)
/satellite/{number} Get details for a specific satellite satellite_number (NORAD ID)
/search Search observations with filters satellite_number, start_date, end_date, min_magnitude, max_magnitude
/satellites List all satellites name (optional - to filter)
/observations/recent Get most recent observations offset, limit (optional)
/observations/stats Get observation statistics None

Example Usage

Common API Examples

1. Search Observations by Date Range:

GET /api/search?start_date=2025-01-01T00:00:00.000Z&end_date=2025-01-31T23:59:59.999Z

Returns all observations between January 1st and January 31st, 2025.

2. Search by Satellite Number:

GET /api/search?satellite_number=58013

Returns all observations for satellite with NORAD ID 58013.

3. Get Recent Observations:

GET /api/observations/recent?limit=10

Returns the 10 most recent observations in the database.

Response Format

All responses include:

  • items: Array of observation results
  • count: Total number of matching observations

Data Format

All responses are returned in JSON format. The API supports pagination for endpoints that return multiple results. Each observation includes:

  • Basic observation details (time, magnitude, uncertainties)
  • Position measurements (RA, Dec, range, range rate)
  • Observer information (instrument, mode, filter)
  • Location data (latitude, longitude, altitude)
  • Associated satellite information
Note

For users who prefer a graphical interface, we recommend using the Search page which provides a user-friendly way to access and download SCORE data.