Observation

GET /udl/eoobservation

Changed on Dec 15, 2025

Service operation to dynamically query data by a variety of query parameters not specified in this API documentation. See the queryhelp operation (/udl/<datatype>/queryhelp) for more details on valid/required query parameter information.

Request

Base URL
https://unifieddatalibrary.com
URL
https://unifieddatalibrary.com/udl/eoobservation
Auth
none declared

Query parameters

obTimestring date-time required

Ob detection time in ISO 8601 UTC, up to microsecond precision. Consumers should contact the provider for details on their obTime specifications. (YYYY-MM-DDTHH:MM:SS.ssssssZ)

firstResultinteger

maxResultsinteger

Response

satNointeger

Satellite/Catalog number of the target on-orbit object.

origNetworkstring

The originating source network on which this record was created, auto-populated by the system.

idstring

Unique identifier of the record, auto-generated by the system.

classificationMarkingstring required

Classification marking of the data in IC/CAPCO Portion-marked format.

obTimestring date-time required

Ob detection time in ISO 8601 UTC, up to microsecond precision. Consumers should contact the provider for details on their obTime specifications.

corrQualitynumber double

Object Correlation Quality score of the observation when compared to a known orbit state (non-standardized). Users should consult data providers regarding the expected range of values.

idOnOrbitstring

Unique identifier of the target on-orbit object, if correlated.

idSensorstring

Unique identifier of the reporting sensor.

idSkyImagerystring

Unique identifier of the Sky Imagery record associated with this observation, if applicable.

collectMethodstring

Method indicating telescope movement during collection (AUTOTRACK, MANUAL AUTOTRACK, MANUAL RATE TRACK, MANUAL SIDEREAL, SIDEREAL, RATE TRACK).

taskIdstring

Optional identifier to indicate the specific tasking which produced this observation.

transactionIdstring

Optional identifier to track a commercial or marketplace transaction executed to produce this data.

trackIdstring

Optional identifier of the track to which this observation belongs.

obPositionstring

The position of this observation within a track (FENCE, FIRST, IN, LAST, SINGLE). This identifier is optional and, if null, no assumption should be made regarding whether other observations may or may not exist to compose a track.

origObjectIdstring

Optional identifier provided by observation source to indicate the target onorbit object of this observation. This may be an internal identifier and not necessarily a valid satellite number.

origSensorIdstring

Optional identifier provided by observation source to indicate the sensor identifier which produced this observation. This may be an internal identifier and not necessarily a valid sensor ID.

uctboolean

Boolean indicating this observation is part of an uncorrelated track or was unable to be correlated to a known object. This flag should only be set to true by data providers after an attempt to correlate to an on-orbit object was made and failed. If unable to correlate, the 'origObjectId' field may be populated with an internal data provider specific identifier.

azimuthnumber double

Line of sight azimuth angle in degrees and topocentric frame. Reported value should include all applicable corrections as specified on the source provider data card. If uncertain, consumers should contact the provider for details on the applied corrections.

azimuthMeasuredboolean

Optional flag indicating whether the azimuth value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

azimuthUncnumber double

One sigma uncertainty in the line of sight azimuth angle, in degrees.

azimuthBiasnumber double

Sensor line of sight azimuth angle bias in degrees.

azimuthRatenumber double

Rate of change of the line of sight azimuth in degrees per second.

elevationnumber double

Line of sight elevation in degrees and topocentric frame. Reported value should include all applicable corrections as specified on the source provider data card. If uncertain, consumers should contact the provider for details on the applied corrections.

elevationMeasuredboolean

Optional flag indicating whether the elevation value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

elevationUncnumber double

One sigma uncertainty in the line of sight elevation angle, in degrees.

elevationBiasnumber double

Sensor line of sight elevation bias, in degrees.

elevationRatenumber double

Rate of change of the line of sight elevation, in degrees per second.

rangenumber double

Line of sight range, in kilometers. Reported value should include all applicable corrections as specified on the source provider data card. If uncertain, consumers should contact the provider for details on the applied corrections.

rangeMeasuredboolean

Optional flag indicating whether the range value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

rangeUncnumber double

One sigma uncertainty in the line of sight range, in kilometers.

rangeBiasnumber double

Sensor line of sight range bias, in kilometers.

rangeRatenumber double

Range rate in kilometers per second. Reported value should include all applicable corrections as specified on the source provider data card. If uncertain, consumers should contact the provider for details on the applied corrections.

rangeRateMeasuredboolean

Optional flag indicating whether the rangeRate value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

rangeRateUncnumber double

One sigma uncertainty in the line of sight range rate, in kilometers per second.

ranumber double

Line of sight right ascension, in degrees, in the specified referenceFrame. If referenceFrame is null then J2K should be assumed. Reported value should include all applicable corrections as specified on the source provider data card. If uncertain, consumers should contact the provider for details on the applied corrections.

raMeasuredboolean

Optional flag indicating whether the ra value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

raRatenumber double

Line of sight right ascension rate of change, in degrees per second, in the specified referenceFrame. If referenceFrame is null then J2K should be assumed.

raUncnumber double

One sigma uncertainty in the line of sight right ascension angle, in degrees.

raBiasnumber double

Sensor line of sight right ascension bias, in degrees.

declinationnumber double

Line of sight declination, in degrees, in the specified referenceFrame. If referenceFrame is null then J2K should be assumed. Reported value should include all applicable corrections as specified on the source provider data card. If uncertain, consumers should contact the provider for details on the applied corrections.

declinationMeasuredboolean

Optional flag indicating whether the declination value is measured (true) or computed (false). If null, consumers may consult the data provider for information regarding whether the corresponding value is computed or measured.

declinationRatenumber double

Line of sight declination rate of change, in degrees per second, in the specified referenceFrame. If referenceFrame is null then J2K should be assumed.

declinationUncnumber double

One sigma uncertainty in the line of sight declination angle, in degrees.

declinationBiasnumber double

Sensor line of sight declination angle bias, in degrees.

losxnumber double

Line-of-sight cartesian X position of the target, in kilometers, in the specified referenceFrame. If referenceFrame is null then J2K should be assumed.

losynumber double

Line-of-sight cartesian Y position of the target, in kilometers, in the specified referenceFrame. If referenceFrame is null then J2K should be assumed.

losznumber double

Line-of-sight cartesian Z position of the target, in kilometers, in the specified referenceFrame. If referenceFrame is null then J2K should be assumed.

losUncnumber double

One sigma uncertainty in the line of sight pointing in micro-radians.

losxvelnumber double

Line-of-sight cartesian X velocity of target, in kilometers per second, in the specified referenceFrame. If referenceFrame is null then J2K should be assumed.

losyvelnumber double

Line-of-sight cartesian Y velocity of target, in kilometers per second, in the specified referenceFrame. If referenceFrame is null then J2K should be assumed.

loszvelnumber double

Line-of-sight cartesian Z velocity of target, in kilometers per second, in the specified referenceFrame. If referenceFrame is null then J2K should be assumed.

senlatnumber double

Sensor WGS84 latitude at obTime (if mobile/onorbit), in degrees. If null, can be obtained from sensor info. -90 to 90 degrees (negative values south of equator).

senlonnumber double

Sensor WGS84 longitude at obTime (if mobile/onorbit), in degrees. If null, can be obtained from sensor info. -180 to 180 degrees (negative values west of Prime Meridian).

senaltnumber double

Sensor altitude at obTime (if mobile/onorbit), in kilometers.

senxnumber double

Cartesian X position of the observing mobile/onorbit sensor at obTime, in kilometers, in the specified senReferenceFrame. If senReferenceFrame is null then J2K should be assumed.

senynumber double

Cartesian Y position of the observing mobile/onorbit sensor at obTime, in kilometers, in the specified senReferenceFrame. If senReferenceFrame is null then J2K should be assumed.

senznumber double

Cartesian Z position of the observing mobile/onorbit sensor at obTime, in kilometers, in the specified senReferenceFrame. If senReferenceFrame is null then J2K should be assumed.

senvelxnumber double

Cartesian X velocity of the observing mobile/onorbit sensor at obTime, in kilometers per second, in the specified senReferenceFrame. If senReferenceFrame is null then J2K should be assumed.

senvelynumber double

Cartesian Y velocity of the observing mobile/onorbit sensor at obTime, in kilometers per second, in the specified senReferenceFrame. If senReferenceFrame is null then J2K should be assumed.

senvelznumber double

Cartesian Z velocity of the observing mobile/onorbit sensor at obTime, in kilometers per second, in the specified senReferenceFrame. If senReferenceFrame is null then J2K should be assumed.

senQuatnumber[]

The quaternion describing the rotation of the sensor in relation to the body-fixed frame used for this system into the local geodetic frame, at observation time (obTime). The array element order convention is scalar component first, followed by the three vector components (qc, q1, q2, q3).

fovCountinteger

The number of RSOs detected in the sensor field of view.

fovCountUCTinteger

The number of uncorrelated tracks in the field of view.

expDurationnumber double

Image exposure duration in seconds. For observations performed using frame stacking or synthetic tracking methods, the exposure duration should be the total integration time. This field is highly recommended / required if the observations are going to be used for photometric processing.

zeroptdnumber double

Formula: 2.5 * log_10 (zero_mag_counts / expDuration).

netObjSignumber double

Net object signature = counts / expDuration.

netObjSigUncnumber double

Net object signature uncertainty = counts uncertainty / expDuration.

magnumber double

Measure of observed brightness calibrated against the Gaia G-band in units of magnitudes.

magUncnumber double

Uncertainty of the observed brightness in units of magnitudes.

magNormRangenumber double

Formula: mag - 5.0 * log_10(geo_range / 1000000.0).

geolatnumber double

For GEO detections, the latitude in degrees north.

geolonnumber double

For GEO detections, the longitude in degrees east.

geoaltnumber double

For GEO detections, the altitude, in kilometers.

georangenumber double

For GEO detections, the range, in kilometers.

skyBkgrndnumber double

Average Sky Background signal, in magnitudes. Sky Background refers to the incoming light from an apparently empty part of the night sky.

primaryExtinctionnumber double

Primary Extinction Coefficient, in magnitudes. Primary Extinction is the coefficient applied to the airmass to determine how much the observed visual magnitude has been attenuated by the atmosphere. Extinction, in general, describes the absorption and scattering of electromagnetic radiation by dust and gas between an emitting astronomical object and the observer. See the EOObservationDetails API for specification of extinction coefficients for multiple spectral filters.

primaryExtinctionUncnumber double

Primary Extinction Coefficient Uncertainty, in magnitudes.

solarPhaseAnglenumber double

The angle, in degrees, between the target-to-observer vector and the target-to-sun vector.

solarEqPhaseAnglenumber double

The angle, in degrees, between the projections of the target-to-observer vector and the target-to-sun vector onto the equatorial plane. The angle is represented as negative when closing (i.e. before the opposition) and positive when opening (after the opposition).

solarDecAnglenumber double

Angle from the sun to the equatorial plane, in degrees.

shutterDelaynumber double

Shutter delay in seconds.

timingBiasnumber double

Sensor timing bias in seconds.

rawFileURIstring

Optional URI location in the document repository of the raw file parsed by the system to produce this record. To download the raw file, prepend https://udl-hostname/scs/download?id= to this value.

intensitynumber double

Intensity of the target for IR observations, in kilowatt per steradian per micrometer.

bgIntensitynumber double

Background intensity for IR observations, in kilowatt per steradian per micrometer.

descriptorstring

Optional source-provided and searchable metadata or descriptor of the data.

sourcestring required

Source of the data.

originstring

Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin.

dataMode'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE' required

Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data:

REAL: Data collected or produced that pertains to real-world objects, events, and analysis.

TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics.

EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data.

SIMULATED: Synthetic data generated by a model to mimic real-world datasets.

createdAtstring date-time

Time the row was created in the database, auto-populated by the system.

createdBystring

Application user who created the row in the database, auto-populated by the system.

zeroPtdUncnumber double

This is the uncertainty in the zero point for the filter used for this observation/row in units of mag. For use with differential photometry.

referenceFrame'J2000' | 'GCRF' | 'ITRF' | 'TEME'

The reference frame of the EOObservation measurements. If the referenceFrame is null it is assumed to be J2000.

The reference frame of the observing sensor state. If the senReferenceFrame is null it is assumed to be J2000.

umbraboolean

Boolean indicating that the target object was in umbral eclipse at the time of this observation.

penumbraboolean

Boolean indicating that the target object was in a penumbral eclipse at the time of this observation.

sourceDLstring

The source data library from which this record was received. This could be a remote or tactical UDL or another data library. If null, the record should be assumed to have originated from the primary Enterprise UDL.

typestring

Read only field specifying the type of observation (e.g. OPTICAL, OPTICAL_IR, LASER_RANGING, etc).

Example response

[
  {
    "satNo": 5,
    "origNetwork": "OPS1",
    "id": "EOOBSERVATION-ID",
    "classificationMarking": "U",
    "obTime": "2018-01-01T16:00:00.123456Z",
    "corrQuality": 1.1,
    "idOnOrbit": "ONORBIT-ID",
    "idSensor": "SENSOR-ID",
    "idSkyImagery": "SKYIMAGERY-ID",
    "collectMethod": "AUTOTRACK",
    "taskId": "TASK-ID",
    "transactionId": "TRANSACTION-ID",
    "trackId": "TRACK-ID",
    "obPosition": "FIRST",
    "origObjectId": "ORIGOBJECT-ID",
    "origSensorId": "ORIGSENSOR-ID",
    "azimuth": 1.1,
    "azimuthMeasured": true,
    "azimuthUnc": 1.1,
    "azimuthBias": 1.1,
    "azimuthRate": 1.1,
    "elevation": 1.1,
    "elevationMeasured": true,
    "elevationUnc": 1.1,
    "elevationBias": 1.1,
    "elevationRate": 1.1,
    "range": 1.1,
    "rangeMeasured": true,
    "rangeUnc": 1.1,
    "rangeBias": 1.1,
    "rangeRate": 1.1,
    "rangeRateMeasured": true,
    "rangeRateUnc": 1.1,
    "ra": 23.4025,
    "raMeasured": true,
    "raRate": 1.1,
    "raUnc": 0.000015,
    "raBias": 1.1,
    "declination": -17.3053,
    "declinationMeasured": true,
    "declinationRate": 1.1,
    "declinationUnc": 0.000015,
    "declinationBias": 1.1,
    "losx": 1.1,
    "losy": 1.1,
    "losz": 1.1,
    "losUnc": 1.1,
    "losxvel": 1.1,
    "losyvel": 1.1,
    "loszvel": 1.1,
    "senlat": 45.1,
    "senlon": 179.1,
    "senalt": 0.7539,
    "senx": 1.1,
    "seny": 1.1,
    "senz": 1.1,
    "senvelx": 1.1,
    "senvely": 1.1,
    "senvelz": 1.1,
    "senQuat": [
      0.4492,
      0.02,
      0.8765,
      0.2213
    ],
    "fovCount": 1,
    "fovCountUCT": 2,
    "expDuration": 1.1,
    "zeroptd": 1.1,
    "netObjSig": 1.1,
    "netObjSigUnc": 1.1,
    "mag": 1.1,
    "magUnc": 1.1,
    "magNormRange": 1.1,
    "geolat": 1.1,
    "geolon": 1.1,
    "geoalt": 1.1,
    "georange": 1.1,
    "skyBkgrnd": 1.1,
    "primaryExtinction": 1.1,
    "primaryExtinctionUnc": 1.1,
    "solarPhaseAngle": 1.1,
    "solarEqPhaseAngle": 1.1,
    "solarDecAngle": 1.1,
    "shutterDelay": 1.1,
    "timingBias": 1.1,
    "rawFileURI": "Example URI",
    "intensity": 1.1,
    "bgIntensity": 1.1,
    "descriptor": "PROVIDED_DATA1",
    "source": "Bluestaq",
    "origin": "THIRD_PARTY_DATASOURCE",
    "dataMode": "TEST",
    "createdAt": "2018-01-01T16:00:00.123Z",
    "createdBy": "some.user",
    "zeroPtdUnc": 1.1,
    "referenceFrame": "J2000",
    "senReferenceFrame": "J2000",
    "sourceDL": "AXE",
    "type": "OPTICAL"
  }
]

Changes

Dec 15, 20257b321e16ea56 Revision changes
- info
  added the optional property / to the response with the status
May 29, 20254e1cbc17e814 Revision changes
- info
  added the new optional query request parameter firstResult
- info
  added the new optional query request parameter maxResults

Some revisions have not been checked yet.

Operation history (3 revisions)