Satellite Information
Retrieve any NORAD ID(s) associated with a satellite name
- GET /norad-ids-from-name/
Find which NORAD ID(s) are associated with a satellite name, can be multiple in the case of temporary IDs
- Query Parameters:
name – (required) – Name of satellite
- Example Request
import requests import json url = 'https://satchecker.cps.iau.org/tools/norad-ids-from-name/' params = {'name': 'STARLINK-1600'} r = requests.get(url, params=params) print(json.dumps(r.json(), indent=4))
curl -X GET "https://satchecker.cps.iau.org/tools/norad-ids-from-name/?name=STARLINK-1600" -H "accept: application/json"
curl.exe -X GET "https://satchecker.cps.iau.org/tools/norad-ids-from-name/?name=STARLINK-1600" -H "accept: application/json"
Example Response
Retrieve any satellite names associated with a NORAD ID
- GET /names-from-norad-id/
Find which satellite names are associated with a given NORAD ID; names can occasionally change so can be more than one
- Query Parameters:
id – (required) – NORAD id of satellite
- Example Request
import requests import json url = 'https://satchecker.cps.iau.org/tools/names-from-norad-id/' params = {'id': '59582'} r = requests.get(url, params=params) print(json.dumps(r.json(), indent=4))
curl -X GET "https://satchecker.cps.iau.org/tools/names-from-norad-id/?id=59582" -H "accept: application/json"
curl.exe -X GET "https://satchecker.cps.iau.org/tools/names-from-norad-id/?id=59582" -H "accept: application/json"
Example Response
{
"count": 2,
"data": [
{
"date_added": "2024-05-01 16:30:20 UTC",
"is_current_version": true,
"name": "STARLINK-31701",
"norad_id": 59582
},
{
"date_added": "2024-04-29 23:12:07 UTC",
"is_current_version": false,
"name": "TBA - TO BE ASSIGNED",
"norad_id": 59582
}
],
"source": "IAU CPS SatChecker",
"version": "1.X.x"
}
Retrieve satellite metadata
- GET /get-satellite-data/
Get the metadata that SatChecker currently has for a given satellite. This includes the satellite’s name, NORAD ID, international designator, launch date, decay date, and any other relevant information.
- Query Parameters:
id – (required) – identifier of satellite (name or NORAD ID)
id_type – (required) – type of identifier: valid values are “name” or “catalog”
- Example Request
import requests import json url = 'https://satchecker.cps.iau.org/tools/get-satellite-data/' params = {'id': '25544', 'id_type': 'catalog' } r = requests.get(url, params=params) print(json.dumps(r.json(), indent=4))
curl -X GET "https://satchecker.cps.iau.org/tools/get-satellite-data/?id=25544&id_type=catalog" -H "accept: application/json"
curl.exe -X GET "https://satchecker.cps.iau.org/tools/get-satellite-data/?id=25544&id_type=catalog" -H "accept: application/json"
Example Response
{
"count": 1,
"data": [
{
"decay_date": null,
"international_designator": "1998-067A",
"launch_date": "1998-11-20",
"object_type": "PAYLOAD",
"rcs_size": "LARGE",
"satellite_id": 25544,
"satellite_name": "ISS (ZARYA)"
}
],
"source": "IAU CPS SatChecker",
"version": "1.X.x"
}
Retrieve active satellites
This endpoint retrieves all active satellites/objects from the database. Active satellites are defined as those with no decay date and as having a current NORAD ID. This endpoint also supports filtering by object type - “PAYLOAD”, “DEBRIS”, “ROCKET BODY”, “TBA”, or “UNKNOWN”.
Endpoint
- GET /tools/get-active-satellites/
Parameters
- Query Parameters:
object_type – (optional) – The type of the object, either “payload”, “debris”, “rocket body”, “tba”, or “unknown”.
Example Request
import requests import json url = 'https://satchecker.cps.iau.org/tools/get-active-satellites/' params = {'object_type': 'unknown'} r = requests.get(url, params=params) print(json.dumps(r.json(), indent=4))
curl -X GET “https://satchecker.cps.iau.org/tools/get-active-satellites/?object_type=unknown” -H “accept: application/json”
curl.exe -X GET “https://satchecker.cps.iau.org/tools/get-active-satellites/?object_type=unknown” -H “accept: application/json”
Example Response
{ "count": 2, "data": [ { "decay_date": null, "international_designator": "2024-110D", "launch_date": "2024-06-06", "object_type": "UNKNOWN", "rcs_size": "SMALL", "satellite_id": 60015, "satellite_name": "OBJECT D" }, { "decay_date": null, "international_designator": "2024-128A", "launch_date": "2024-07-09", "object_type": "UNKNOWN", "rcs_size": "SMALL", "satellite_id": 60235, "satellite_name": "OBJECT A" } ], "source": "IAU CPS SatChecker", "version": "1.X.x"
}
Search all satellites
This endpoint allows for searching all satellites/objects in the database. Search parameters include the satellite name, NORAD ID, international designator, launch date, decay date, and object type.
Endpoint
- GET /tools/search-satellites/
Parameters
- Query Parameters:
name – (optional) – The name of the satellite (partial matches supported)
norad_id – (optional) – The NORAD ID/catalog number of the satellite
object_id – (optional) – The international designator/COSPAR ID (e.g., “1998-067A”)
rcs_size – (optional) – The radar cross-section size (“SMALL”, “MEDIUM”, “LARGE”)
launch_id – (optional) – Search by launch ID (partial international designator, e.g., “1998-067”)
object_type – (optional) – The type of object (“PAYLOAD”, “DEBRIS”, “ROCKET BODY”, “TBA”, “UNKNOWN”)
launch_date_start – (optional) – Filter objects launched after this date (Julian Date)
launch_date_end – (optional) – Filter objects launched before this date (Julian Date)
decay_date_start – (optional) – Filter objects that decayed after this date (Julian Date)
decay_date_end – (optional) – Filter objects that decayed before this date (Julian Date)
Example Request
import requests import json url = 'https://satchecker.cps.iau.org/tools/search-satellites/' params = { 'object_type': 'payload', 'launch_date_start': '2460311.5' } r = requests.get(url, params=params) print(json.dumps(r.json(), indent=4))
curl -X GET "https://satchecker.cps.iau.org/tools/search-satellites/?object_type=payload&launch_date_start=2024-01-01" -H "accept: application/json"
curl.exe -X GET "https://satchecker.cps.iau.org/tools/search-satellites/?object_type=payload&launch_date_start=2024-01-01" -H "accept: application/json"
Example Response
{ "count": 2, "data": [ { "decay_date": null, "international_designator": "2024-110D", "launch_date": "2024-06-06", "object_type": "PAYLOAD", "rcs_size": "SMALL", "satellite_id": 60015, "satellite_name": "STARLINK-5234" }, { "decay_date": null, "international_designator": "2024-128A", "launch_date": "2024-07-09", "object_type": "PAYLOAD", "rcs_size": "SMALL", "satellite_id": 60235, "satellite_name": "STARLINK-5678" } ], "source": "IAU CPS SatChecker", "version": "1.X.x" }
Retrieve Starlink generations
This endpoint retrieves all Starlink generations from the database, including their earliest and latest launch dates.
Endpoint
- GET /tools/get-starlink-generations/
Example Request
import requests import json url = 'https://satchecker.cps.iau.org/tools/get-starlink-generations/' r = requests.get(url, params=params) print(json.dumps(r.json(), indent=4))
curl -X GET “https://satchecker.cps.iau.org/tools/get-starlink-generations/” -H “accept: application/json”
curl.exe -X GET “https://satchecker.cps.iau.org/tools/get-starlink-generations/” -H “accept: application/json”
Example Response
{ "count": 4, "data": [ { "earliest_launch_date": "2019-05-24 00:00:00 UTC", "generation": "v0.9", "latest_launch_date": "2019-05-24 00:00:00 UTC" }, { "earliest_launch_date": "2019-11-11 00:00:00 UTC", "generation": "v1", "latest_launch_date": "2021-05-26 00:00:00 UTC" }, { "earliest_launch_date": "2021-06-30 00:00:00 UTC", "generation": "v1.5", "latest_launch_date": "2023-07-16 00:00:00 UTC" }, { "earliest_launch_date": "2023-02-27 00:00:00 UTC", "generation": "v2 mini", "latest_launch_date": "2025-05-28 00:00:00 UTC" } ], "source": "IAU CPS SatChecker", "version": "1.X.x" }