Space-Track · Schema

SATCAT Record

Satellite catalog (SATCAT) record as returned by the Space-Track /basicspacedata/query/class/satcat/ endpoint. Provides catalog metadata for all tracked Earth-orbiting objects.

SpaceSatellitesTLEOrbital DataSpace SurveillanceDebris TrackingConjunction DataUS Military

Properties

Name	Type	Description
INTLDES	string	International designator in YYYY-NNNPPP format
NORAD_CAT_ID	string	NORAD catalog number
OBJECT_TYPE	string	Object type classification
SATNAME	string	Official satellite or object name
COUNTRY	string	Country or organization code of ownership/registration
LAUNCH	stringnull	Launch date in YYYY-MM-DD format (UTC)
SITE	stringnull	Launch site code corresponding to SATCAT launch_site class
DECAY	stringnull	Reentry/decay date if decayed; null if still in orbit
PERIOD	stringnull	Orbital period in minutes
INCLINATION	stringnull	Orbital inclination in degrees
APOGEE	stringnull	Apogee altitude above Earth surface in km
PERIGEE	stringnull	Perigee altitude above Earth surface in km
COMMENT	stringnull	Optional comment text
COMMENTCODE	stringnull	Optional comment code
RCSVALUE	string	Radar cross-section value in m^2 (0 if unknown)
RCS_SIZE	stringnull	Radar cross-section size category
FILE	string	Internal file reference identifier
LAUNCH_YEAR	string	4-digit launch year
LAUNCH_NUM	string	Sequential launch number within the launch year
LAUNCH_PIECE	string	Piece letter identifier within the launch
CURRENT	string	Whether the object is currently tracked in orbit (Y = in orbit, N = decayed)
OBJECT_NAME	string	Object name (same as SATNAME)
OBJECT_ID	string	International designator (same as INTLDES)
OBJECT_NUMBER	string	NORAD catalog number as an integer string

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/spacetrack/main/json-schema/satcat-record.json",
  "title": "SATCAT Record",
  "description": "Satellite catalog (SATCAT) record as returned by the Space-Track /basicspacedata/query/class/satcat/ endpoint. Provides catalog metadata for all tracked Earth-orbiting objects.",
  "type": "object",
  "properties": {
    "INTLDES": {
      "type": "string",
      "description": "International designator in YYYY-NNNPPP format",
      "examples": ["1998-067A", "2020-001A"]
    },
    "NORAD_CAT_ID": {
      "type": "string",
      "description": "NORAD catalog number",
      "examples": ["25544"]
    },
    "OBJECT_TYPE": {
      "type": "string",
      "description": "Object type classification",
      "enum": ["PAYLOAD", "ROCKET BODY", "DEBRIS", "UNKNOWN", "TBA"]
    },
    "SATNAME": {
      "type": "string",
      "description": "Official satellite or object name",
      "examples": ["ISS (ZARYA)", "STARLINK-1234"]
    },
    "COUNTRY": {
      "type": "string",
      "description": "Country or organization code of ownership/registration",
      "examples": ["US", "CIS", "ISS", "PRC", "ESA"]
    },
    "LAUNCH": {
      "type": ["string", "null"],
      "format": "date",
      "description": "Launch date in YYYY-MM-DD format (UTC)",
      "examples": ["1998-11-20", "2020-01-07"]
    },
    "SITE": {
      "type": ["string", "null"],
      "description": "Launch site code corresponding to SATCAT launch_site class",
      "examples": ["TTMTR", "AFETR", "SVOB"]
    },
    "DECAY": {
      "type": ["string", "null"],
      "format": "date",
      "description": "Reentry/decay date if decayed; null if still in orbit",
      "examples": ["2024-01-15", null]
    },
    "PERIOD": {
      "type": ["string", "null"],
      "description": "Orbital period in minutes",
      "examples": ["92.68", "1436.1"]
    },
    "INCLINATION": {
      "type": ["string", "null"],
      "description": "Orbital inclination in degrees",
      "examples": ["51.64", "97.8", "0.02"]
    },
    "APOGEE": {
      "type": ["string", "null"],
      "description": "Apogee altitude above Earth surface in km",
      "examples": ["421", "35793"]
    },
    "PERIGEE": {
      "type": ["string", "null"],
      "description": "Perigee altitude above Earth surface in km",
      "examples": ["417", "35775"]
    },
    "COMMENT": {
      "type": ["string", "null"],
      "description": "Optional comment text"
    },
    "COMMENTCODE": {
      "type": ["string", "null"],
      "description": "Optional comment code"
    },
    "RCSVALUE": {
      "type": "string",
      "description": "Radar cross-section value in m^2 (0 if unknown)",
      "examples": ["0", "473.2"]
    },
    "RCS_SIZE": {
      "type": ["string", "null"],
      "description": "Radar cross-section size category",
      "enum": ["SMALL", "MEDIUM", "LARGE", null],
      "examples": ["LARGE", "SMALL"]
    },
    "FILE": {
      "type": "string",
      "description": "Internal file reference identifier"
    },
    "LAUNCH_YEAR": {
      "type": "string",
      "description": "4-digit launch year",
      "pattern": "^[0-9]{4}$",
      "examples": ["1998", "2020"]
    },
    "LAUNCH_NUM": {
      "type": "string",
      "description": "Sequential launch number within the launch year",
      "examples": ["67", "1"]
    },
    "LAUNCH_PIECE": {
      "type": "string",
      "description": "Piece letter identifier within the launch",
      "examples": ["A", "B", "AA", "ZZZ"]
    },
    "CURRENT": {
      "type": "string",
      "description": "Whether the object is currently tracked in orbit (Y = in orbit, N = decayed)",
      "enum": ["Y", "N"]
    },
    "OBJECT_NAME": {
      "type": "string",
      "description": "Object name (same as SATNAME)",
      "examples": ["ISS (ZARYA)"]
    },
    "OBJECT_ID": {
      "type": "string",
      "description": "International designator (same as INTLDES)",
      "examples": ["1998-067A"]
    },
    "OBJECT_NUMBER": {
      "type": "string",
      "description": "NORAD catalog number as an integer string",
      "examples": ["25544"]
    }
  },
  "required": [
    "NORAD_CAT_ID",
    "INTLDES",
    "OBJECT_TYPE",
    "SATNAME",
    "COUNTRY",
    "CURRENT"
  ],
  "additionalProperties": true
}