--- title: "GET /udl/eoobservation" method: GET path: "/udl/eoobservation" tags: ["Observation"] --- # GET /udl/eoobservation `GET /udl/eoobservation` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/eoobservation` - Auth: none declared Service operation to dynamically query data by a variety of query parameters not specified in this API documentation. See the queryhelp operation (`/udl//queryhelp`) for more details on valid/required query parameter information. ## Query parameters - `obTime` string, date-time, required - `firstResult` integer - `maxResults` integer ## Response `200` OK - EOObservationAbridged[] - `satNo` integer: Satellite/Catalog number of the target on-orbit object. - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. - `id` string: Unique identifier of the record, auto-generated by the system. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `obTime` string, 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. - `corrQuality` number, 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. - `idOnOrbit` string: Unique identifier of the target on-orbit object, if correlated. - `idSensor` string: Unique identifier of the reporting sensor. - `idSkyImagery` string: Unique identifier of the Sky Imagery record associated with this observation, if applicable. - `collectMethod` string: Method indicating telescope movement during collection (AUTOTRACK, MANUAL AUTOTRACK, MANUAL RATE TRACK, MANUAL SIDEREAL, SIDEREAL, RATE TRACK). - `taskId` string: Optional identifier to indicate the specific tasking which produced this observation. - `transactionId` string: Optional identifier to track a commercial or marketplace transaction executed to produce this data. - `trackId` string: Optional identifier of the track to which this observation belongs. - `obPosition` string: 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. - `origObjectId` string: 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. - `origSensorId` string: 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. - `uct` boolean: 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. - `azimuth` number, 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. - `azimuthMeasured` boolean: 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. - `azimuthUnc` number, double: One sigma uncertainty in the line of sight azimuth angle, in degrees. - `azimuthBias` number, double: Sensor line of sight azimuth angle bias in degrees. - `azimuthRate` number, double: Rate of change of the line of sight azimuth in degrees per second. - `elevation` number, 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. - `elevationMeasured` boolean: 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. - `elevationUnc` number, double: One sigma uncertainty in the line of sight elevation angle, in degrees. - `elevationBias` number, double: Sensor line of sight elevation bias, in degrees. - `elevationRate` number, double: Rate of change of the line of sight elevation, in degrees per second. - `range` number, 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. - `rangeMeasured` boolean: 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. - `rangeUnc` number, double: One sigma uncertainty in the line of sight range, in kilometers. - `rangeBias` number, double: Sensor line of sight range bias, in kilometers. - `rangeRate` number, 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. - `rangeRateMeasured` boolean: 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. - `rangeRateUnc` number, double: One sigma uncertainty in the line of sight range rate, in kilometers per second. - `ra` number, 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. - `raMeasured` boolean: 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. - `raRate` number, 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. - `raUnc` number, double: One sigma uncertainty in the line of sight right ascension angle, in degrees. - `raBias` number, double: Sensor line of sight right ascension bias, in degrees. - `declination` number, 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. - `declinationMeasured` boolean: 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. - `declinationRate` number, 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. - `declinationUnc` number, double: One sigma uncertainty in the line of sight declination angle, in degrees. - `declinationBias` number, double: Sensor line of sight declination angle bias, in degrees. - `losx` number, 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. - `losy` number, 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. - `losz` number, 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. - `losUnc` number, double: One sigma uncertainty in the line of sight pointing in micro-radians. - `losxvel` number, 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. - `losyvel` number, 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. - `loszvel` number, 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. - `senlat` number, 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). - `senlon` number, 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). - `senalt` number, double: Sensor altitude at obTime (if mobile/onorbit), in kilometers. - `senx` number, 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. - `seny` number, 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. - `senz` number, 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. - `senvelx` number, 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. - `senvely` number, 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. - `senvelz` number, 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. - `senQuat` number[]: 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). - `fovCount` integer: The number of RSOs detected in the sensor field of view. - `fovCountUCT` integer: The number of uncorrelated tracks in the field of view. - `expDuration` number, 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. - `zeroptd` number, double: Formula: 2.5 * log_10 (zero_mag_counts / expDuration). - `netObjSig` number, double: Net object signature = counts / expDuration. - `netObjSigUnc` number, double: Net object signature uncertainty = counts uncertainty / expDuration. - `mag` number, double: Measure of observed brightness calibrated against the Gaia G-band in units of magnitudes. - `magUnc` number, double: Uncertainty of the observed brightness in units of magnitudes. - `magNormRange` number, double: Formula: mag - 5.0 * log_10(geo_range / 1000000.0). - `geolat` number, double: For GEO detections, the latitude in degrees north. - `geolon` number, double: For GEO detections, the longitude in degrees east. - `geoalt` number, double: For GEO detections, the altitude, in kilometers. - `georange` number, double: For GEO detections, the range, in kilometers. - `skyBkgrnd` number, double: Average Sky Background signal, in magnitudes. Sky Background refers to the incoming light from an apparently empty part of the night sky. - `primaryExtinction` number, 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. - `primaryExtinctionUnc` number, double: Primary Extinction Coefficient Uncertainty, in magnitudes. - `solarPhaseAngle` number, double: The angle, in degrees, between the target-to-observer vector and the target-to-sun vector. - `solarEqPhaseAngle` number, 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). - `solarDecAngle` number, double: Angle from the sun to the equatorial plane, in degrees. - `shutterDelay` number, double: Shutter delay in seconds. - `timingBias` number, double: Sensor timing bias in seconds. - `rawFileURI` string: 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. - `intensity` number, double: Intensity of the target for IR observations, in kilowatt per steradian per micrometer. - `bgIntensity` number, double: Background intensity for IR observations, in kilowatt per steradian per micrometer. - `descriptor` string: Optional source-provided and searchable metadata or descriptor of the data. - `source` string, required: Source of the data. - `origin` string: 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. - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system. - `createdBy` string: Application user who created the row in the database, auto-populated by the system. - `zeroPtdUnc` number, 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. - `senReferenceFrame` 'J2000' | 'EFG/TDR' | 'ECR/ECEF' | 'TEME' | 'ITRF' | 'GCRF': The reference frame of the observing sensor state. If the senReferenceFrame is null it is assumed to be J2000. - `umbra` boolean: Boolean indicating that the target object was in umbral eclipse at the time of this observation. - `penumbra` boolean: Boolean indicating that the target object was in a penumbral eclipse at the time of this observation. - `sourceDL` string: 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. - `type` string: Read only field specifying the type of observation (e.g. OPTICAL, OPTICAL_IR, LASER_RANGING, etc). ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `405`: Method Not Allowed - `406`: MediaType Not Accepted by Request Headers - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2025-12-15** `7b321e16ea56`: 1 info - added the optional property `items/zeroPtdUnc` to the response with the `200` status - **2025-05-29** `4e1cbc17e814`: 2 info - added the new optional `query` request parameter `firstResult` - added the new optional `query` request parameter `maxResults` - **2025-04-16** `75f764c843a9`: 9 info - api operation id `findAllWithStream_7` removed and replaced with `` - the endpoint scheme security `BasicAuth` was removed from the API - added the optional property `items/azimuthMeasured` to the response with the `200` status - added the optional property `items/declinationMeasured` to the response with the `200` status - …5 more [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/eoobservation/get.md) --- [API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)