GP Record

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/spacetrack/main/json-schema/gp-record.json",
  "title": "GP Record",
  "description": "General Perturbations (GP) orbital element set in CCSDS OMM format, as returned by the Space-Track /basicspacedata/query/class/gp/ endpoint.",
  "type": "object",
  "properties": {
    "CCSDS_OMM_VERS": {
      "type": "string",
      "description": "CCSDS Orbit Mean-Elements Message version",
      "examples": ["2.0"]
    },
    "COMMENT": {
      "type": "string",
      "description": "OMM comment field, typically 'GENERATED VIA SPACE-TRACK.ORG API'"
    },
    "CREATION_DATE": {
      "type": "string",
      "format": "date-time",
      "description": "Date and time the element set was created, in UTC"
    },
    "ORIGINATOR": {
      "type": "string",
      "description": "Organization that originated the element set",
      "examples": ["18 SPCS"]
    },
    "OBJECT_NAME": {
      "type": "string",
      "description": "Common name of the tracked object",
      "examples": ["ISS (ZARYA)", "STARLINK-1234"]
    },
    "OBJECT_ID": {
      "type": "string",
      "description": "International designator in YYYY-NNNPPP format",
      "pattern": "^[0-9]{4}-[0-9]{3}[A-Z]+$",
      "examples": ["1998-067A", "2020-001A"]
    },
    "NORAD_CAT_ID": {
      "type": "string",
      "description": "NORAD catalog number (integer string, 1-339999)",
      "pattern": "^[0-9]{1,6}$",
      "examples": ["25544", "100001"]
    },
    "OBJECT_TYPE": {
      "type": "string",
      "description": "Object classification type",
      "enum": ["PAYLOAD", "ROCKET BODY", "DEBRIS", "UNKNOWN", "TBA"]
    },
    "CLASSIFICATION_TYPE": {
      "type": "string",
      "description": "Classification type: U = Unclassified",
      "enum": ["U"],
      "examples": ["U"]
    },
    "INTLDES": {
      "type": "string",
      "description": "International designator (same as OBJECT_ID)",
      "examples": ["1998-067A"]
    },
    "EPHEMERIS_TYPE": {
      "type": "string",
      "description": "Type of ephemeris: 0 = SGP4",
      "enum": ["0", "1", "2", "3", "4", "5"],
      "examples": ["0"]
    },
    "ELEMENT_SET_NO": {
      "type": "string",
      "description": "Element set number (incremented with each update)",
      "examples": ["9999"]
    },
    "EPOCH": {
      "type": "string",
      "format": "date-time",
      "description": "Reference epoch of the element set in UTC"
    },
    "MEAN_MOTION": {
      "type": "string",
      "description": "Mean motion in revolutions per day",
      "examples": ["15.49957327"]
    },
    "ECCENTRICITY": {
      "type": "string",
      "description": "Orbital eccentricity (dimensionless, 0.0 to <1.0)",
      "examples": ["0.0001234"]
    },
    "INCLINATION": {
      "type": "string",
      "description": "Inclination of the orbit in degrees (0 to 180)",
      "examples": ["51.6395", "97.8"]
    },
    "RA_OF_ASC_NODE": {
      "type": "string",
      "description": "Right ascension of ascending node in degrees (0 to 360)",
      "examples": ["123.4567"]
    },
    "ARG_OF_PERICENTER": {
      "type": "string",
      "description": "Argument of pericenter in degrees (0 to 360)",
      "examples": ["234.5678"]
    },
    "MEAN_ANOMALY": {
      "type": "string",
      "description": "Mean anomaly in degrees (0 to 360)",
      "examples": ["345.6789"]
    },
    "MEAN_MOTION_DOT": {
      "type": "string",
      "description": "First time derivative of mean motion (rev/day^2), encodes atmospheric drag",
      "examples": ["0.00001234", "-0.00000100"]
    },
    "MEAN_MOTION_DDOT": {
      "type": "string",
      "description": "Second time derivative of mean motion (rev/day^3)",
      "examples": ["0", "0.00000000e+0"]
    },
    "BSTAR": {
      "type": "string",
      "description": "SGP4-type drag coefficient (BSTAR, in Earth radii^-1)",
      "examples": ["0.00001234", "1.2345e-5"]
    },
    "REV_AT_EPOCH": {
      "type": "string",
      "description": "Revolution number at epoch",
      "examples": ["43210"]
    },
    "SEMIMAJOR_AXIS": {
      "type": "string",
      "description": "Derived semi-major axis in km"
    },
    "PERIOD": {
      "type": "string",
      "description": "Derived orbital period in minutes",
      "examples": ["92.68"]
    },
    "APOGEE": {
      "type": "string",
      "description": "Derived apogee altitude above Earth's surface in km",
      "examples": ["421"]
    },
    "PERIGEE": {
      "type": "string",
      "description": "Derived perigee altitude above Earth's surface in km",
      "examples": ["417"]
    },
    "DECAY_DATE": {
      "type": ["string", "null"],
      "format": "date",
      "description": "Date of reentry/decay if the object has decayed; null if still in orbit"
    },
    "FILE": {
      "type": "string",
      "description": "Internal Space-Track file identifier"
    },
    "GP_ID": {
      "type": "string",
      "description": "Unique identifier for this GP element set record"
    },
    "TLE_LINE0": {
      "type": "string",
      "description": "TLE line 0 — object name line (only present in TLE/3LE format output)"
    },
    "TLE_LINE1": {
      "type": "string",
      "description": "TLE line 1 — 69-character first data line",
      "minLength": 69,
      "maxLength": 69,
      "examples": ["1 25544U 98067A   24015.43750000  .00020137  00000-0  16538-3 0  9993"]
    },
    "TLE_LINE2": {
      "type": "string",
      "description": "TLE line 2 — 69-character second data line",
      "minLength": 69,
      "maxLength": 69,
      "examples": ["2 25544  51.6395 123.4567 0001234 234.5678 345.6789 15.49957327 43210"]
    }
  },
  "required": [
    "NORAD_CAT_ID",
    "EPOCH",
    "MEAN_MOTION",
    "ECCENTRICITY",
    "INCLINATION",
    "RA_OF_ASC_NODE",
    "ARG_OF_PERICENTER",
    "MEAN_ANOMALY"
  ],
  "additionalProperties": true
}