Ephemeris

Create Ephemeris

Changed on

Upload an ephemeris file to Kayhan's system.<br/> Uploaded ephemerides can be added to a Screening using POST /screenings/{id}/primaries.<br/> NOTE: Only ephemerides using an inertial reference frame are accepted at this time.

post/ephemerides

Request

  • Base URL: https://api.satcat.com/api/satcat
  • URL: https://api.satcat.com/api/satcat/ephemerides
  • Auth: OAuth 2 (client credentials, token URL oauth/token; password, token URL login)

Query parameters

group_idstring uuid nullable

Optional group ID to use for the request

Request body multipart/form-data

norad_idstring nullable

NORAD catalog number of the object. If not provided, Satcat will attempt to infer the NORAD ID based on the filename of the uploaded file using the 18SpCS filename convention from the Spaceflight Safety Handbook.

file_format'OEM' | 'OCM' | 'NASA' | 'GOOE' | 'SP' | 'MOD_ITC' | 'CALIPER' | 'HDF5' | 'AUTOMATIC' | 'STK'

Supported Ephemeris file formats for reading

hbr_mnumber nullable

Hard Body Radius (in meters) to use when computing collision probability using this Ephemeris. Some ephemeris formats may include HBR information; if both are provided, this value is treated as an override. If not provided, HBR will be estimated based on the object type designation in the public catalog.

commentsstring nullable

User comments

ephemeris_filestring binary

Ephemeris file to upload

context'ROUTINE' | 'COLA' | 'MAINTENANCE' | 'NOVEL' | 'DECAY'
designation'OPERATIONAL' | 'PREDICTIVE' | 'DEFINITIVE' | 'THEORETICAL' | 'TLE'
originatorstring nullable

Originator of the ephemeris

repository_publicboolean nullable
event_publicboolean nullable
owning_group_idstring uuid nullable

Group ID to own this ephemeris. Can only be set by super users and is intended to upload of PREDICTIVE ephemeris by Kayhan OD

ephemeris_type'ON_ORBIT' | 'LAUNCH'

Response

Successful Response

idstring uuid nullable
rso_idstring uuid nullable
filenamestring nullable
data_format'hdf5' | 'original' | 'gem'
custom_storage_pathstring nullable
altitude_kmnumber nullable
repository_publicboolean
event_publicboolean
user_idstring uuid nullable
group_idstring uuid nullable
covariance_correctedboolean nullable
source_ephemeris_idstring uuid nullable
norad_idinteger nullable
ephemeris_source'CATALOG' | 'SPACE_TRACK_PUBLIC' | 'SPACE_TRACK_PUBLIC_SATCAT' | 'PATHFINDER_API' | 'SATCAT_API' | 'USER_SCREENER' | 'TERTIARY_SCREENER' | 'PATHFINDER_AUTO_THIRDPARTY' | 'KAYHAN_INTERNAL_PROCESS' | 'EXTRACTED_FROM_CDM' | 'PATHFINDER_SCREENER_THIRDPARTY' | 'STARLINK_API_PUBLIC' | 'PUBLIC_REPOSITORY' | 'STARLINK_STC_API' required
solution_timestring date-time nullable
has_covarianceboolean required
covariance_generatedboolean nullable
ephemeris_type'ON_ORBIT' | 'LAUNCH' required
discontinuitiesstring[]
commentsstring nullable
apogee_kmnumber required
perigee_kmnumber required
archivedboolean
hbr_mnumber nullable
current_operationalboolean
launch_timestring date-time nullable
usable_time_startstring date-time nullable
usable_time_endstring date-time nullable
context'ROUTINE' | 'COLA' | 'MAINTENANCE' | 'NOVEL' | 'DECAY'
designation'OPERATIONAL' | 'PREDICTIVE' | 'DEFINITIVE' | 'THEORETICAL' | 'TLE'

Changes