US Space Command

opencollection: 1.0.0
info:
  name: Space-Track.org REST API
  version: '1.0'
request:
  auth:
    type: apikey
    key: chocolatechip
    value: '{{chocolatechip}}'
    placement: query
items:
- info:
    name: Authentication
    type: folder
  items:
  - info:
      name: Authenticate with Space-Track.org
      type: http
    http:
      method: POST
      url: https://www.space-track.org/ajaxauth/login
      body:
        type: form-urlencoded
        data:
        - name: identity
          value: ''
        - name: password
          value: ''
    docs: Authenticate using username and password credentials. On success, a session cookie is returned for use in subsequent
      API requests.
- info:
    name: General Perturbations
    type: folder
  items:
  - info:
      name: List Current General Perturbation Orbital Elements
      type: http
    http:
      method: GET
      url: https://www.space-track.org/basicspacedata/query/class/gp/format/:format
      params:
      - name: format
        value: ''
        type: path
        description: Response format
      - name: NORAD_CAT_ID
        value: ''
        type: query
        description: NORAD catalog number (e.g., 25544 for ISS)
      - name: OBJECT_NAME
        value: ''
        type: query
        description: Object name (supports wildcard ~~)
      - name: EPOCH
        value: ''
        type: query
        description: Epoch filter (e.g., >now-30 for last 30 days)
      - name: DECAY_DATE
        value: ''
        type: query
        description: Filter for active (null-val) or decayed objects
      - name: INCLINATION
        value: ''
        type: query
        description: Orbital inclination filter
      - name: PERIOD
        value: ''
        type: query
        description: Orbital period filter (minutes)
      - name: APOGEE
        value: ''
        type: query
        description: Apogee altitude filter (km)
      - name: PERIGEE
        value: ''
        type: query
        description: Perigee altitude filter (km)
      - name: COUNTRY_CODE
        value: ''
        type: query
        description: ISO country code of object owner
      - name: orderby
        value: ''
        type: query
        description: Sort field and direction (e.g., NORAD_CAT_ID asc)
      - name: limit
        value: ''
        type: query
        description: Max number of results
    docs: Returns the latest orbital element sets (GP/TLEs) for tracked objects. The GP class provides the newest element
      set per object.
- info:
    name: Satellite Catalog
    type: folder
  items:
  - info:
      name: Query Satellite Catalog (SATCAT)
      type: http
    http:
      method: GET
      url: https://www.space-track.org/basicspacedata/query/class/satcat/format/:format
      params:
      - name: format
        value: ''
        type: path
      - name: NORAD_CAT_ID
        value: ''
        type: query
        description: NORAD catalog number
      - name: INTLDES
        value: ''
        type: query
        description: International designator (e.g., 1998-067A for ISS)
      - name: OBJECT_NAME
        value: ''
        type: query
        description: Object name (supports wildcard ~~)
      - name: OBJECT_TYPE
        value: ''
        type: query
        description: Type filter (PAYLOAD, ROCKET BODY, DEBRIS, UNKNOWN)
      - name: COUNTRY_CODE
        value: ''
        type: query
        description: Country code filter
      - name: LAUNCH_DATE
        value: ''
        type: query
        description: Launch date filter
      - name: DECAY_DATE
        value: ''
        type: query
        description: Decay date (use null-val for active objects)
      - name: orderby
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
    docs: Returns satellite catalog information including object metadata, launch dates, countries of origin, and object classification.
  - info:
      name: Get Space Object Counts by Country (Boxscore)
      type: http
    http:
      method: GET
      url: https://www.space-track.org/basicspacedata/query/class/boxscore/format/:format
      params:
      - name: format
        value: ''
        type: path
    docs: Returns a count of tracked space objects by country and object type.
- info:
    name: Conjunction Data
    type: folder
  items:
  - info:
      name: List Conjunction Data Messages (CDM)
      type: http
    http:
      method: GET
      url: https://www.space-track.org/basicspacedata/query/class/cdm_public/format/:format
      params:
      - name: format
        value: ''
        type: path
      - name: SAT_1_ID
        value: ''
        type: query
        description: NORAD ID of primary object
      - name: SAT_2_ID
        value: ''
        type: query
        description: NORAD ID of secondary object
      - name: TCA_RANGE_START
        value: ''
        type: query
        description: Time of closest approach start filter (ISO 8601)
      - name: TCA_RANGE_END
        value: ''
        type: query
        description: Time of closest approach end filter (ISO 8601)
      - name: PC
        value: ''
        type: query
        description: Probability of collision filter (e.g., >0.0001)
      - name: MISS_DISTANCE
        value: ''
        type: query
        description: Miss distance filter (km)
      - name: orderby
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
    docs: Returns publicly available Conjunction Data Messages (CDMs), which are notifications of potential close approaches
      between tracked objects. Sorted by collision probability descending.
- info:
    name: Decay and Reentry
    type: folder
  items:
  - info:
      name: List Satellite Decay Data
      type: http
    http:
      method: GET
      url: https://www.space-track.org/basicspacedata/query/class/decay/format/:format
      params:
      - name: format
        value: ''
        type: path
      - name: NORAD_CAT_ID
        value: ''
        type: query
      - name: DECAY_EPOCH
        value: ''
        type: query
        description: Decay date filter
      - name: orderby
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
    docs: Returns decay information for space objects that have reentered the atmosphere.
  - info:
      name: List Tracking and Impact Predictions (TIP)
      type: http
    http:
      method: GET
      url: https://www.space-track.org/basicspacedata/query/class/tip/format/:format
      params:
      - name: format
        value: ''
        type: path
      - name: NORAD_CAT_ID
        value: ''
        type: query
      - name: CCSDS_OD_SPAN
        value: ''
        type: query
      - name: orderby
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
    docs: Returns Tracking and Impact Prediction (TIP) messages for objects expected to reenter the atmosphere.
- info:
    name: Space Object History
    type: folder
  items:
  - info:
      name: List Historical General Perturbation Elements
      type: http
    http:
      method: GET
      url: https://www.space-track.org/basicspacedata/query/class/gp_history/format/:format
      params:
      - name: format
        value: ''
        type: path
      - name: NORAD_CAT_ID
        value: ''
        type: query
        description: NORAD catalog number (required to prevent full table scans)
      - name: EPOCH
        value: ''
        type: query
        description: Epoch date range filter
      - name: orderby
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
    docs: Returns historical orbital element sets. Contains 138+ million records. Use with caution — apply filters to avoid
      large downloads.
bundled: true