--- title: "GET /udl/rfobservation" method: GET path: "/udl/rfobservation" tags: ["Observation"] --- # GET /udl/rfobservation `GET /udl/rfobservation` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/rfobservation` - 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 - RFObservationAbridged[] - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. - `type` string, required: Type of RF ob (e.g. RF, RF-SOSI, PSD, RFI, SPOOF, etc). - `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 with microsecond precision. - `idOnOrbit` string: Unique identifier of the target on-orbit object, if correlated. - `idSensor` string: Unique identifier of the reporting sensor. - `satNo` integer: Satellite/Catalog number of the target on-orbit object. - `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. - `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. - `transponder` string: Optional identifier provided by observation source to indicate the transponder used for this measurement. - `azimuth` number, double: Azimuth angle in degrees and topocentric coordinate frame. - `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 azimuth angle measurement, in degrees. - `azimuthRate` number, double: Rate of change of the azimuth in degrees per second. - `elevation` number, double: Elevation in degrees and topocentric coordinate frame. - `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 elevation angle measurement, in degrees. - `elevationRate` number, double: Rate of change of the elevation in degrees per second. - `range` number, double: Target range in kilometers. - `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 range measurement, in kilometers. - `rangeRate` number, double: Rate of change of the range in kilometers per second. - `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 range rate measurement, in kilometers/second. - `trackRange` number, double: Target track or apparent range in kilometers. - `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 km. If null, can be obtained from sensor info. - `elnot` string: ELINT notation. - `frequency` number, double: Center carrier frequency in hertz. - `nominalFrequency` number, double: Nominal or expected center carrier frequency in hertz. - `startFrequency` number, double: Start carrier frequency in hertz. - `endFrequency` number, double: End carrier frequency in hertz. - `relativeCarrierPower` number, double: Measured power of the center carrier frequency in decibel watts. - `spectrumAnalyzerPower` number, double: Measured spectrum analyzer power of the center carrier frequency in decibel watts. - `relativeNoiseFloor` number, double: The measure of the signal created from the sum of all the noise sources and unwanted signals within the measurement system, in decibel watts. - `referenceLevel` number, double: Reference signal level, in decibel watts. - `pgri` number, double: A pulse group repetition interval (PGRI) is a pulse train in which there are groups of closely spaced pulses separated by much longer times between these pulse groups. The PGRI is measured in seconds. - `confidence` number, double: Confidence in the signal and its measurements and characterization. - `incoming` boolean: True if the signal is incoming, false if outgoing. - `switchPoint` integer: Switch Point of the RFObservation record. - `baudRate` number, double: Baud rate is the number of symbol changes, waveform changes, or signaling events, across the transmission medium per second. - `snr` number, double: Signal to noise ratio, in decibels. - `nominalSnr` number, double: Nominal or expected signal to noise ratio, in decibels. - `polarity` number, double: The antenna pointing dependent polarizer angle, in degrees. - `polarityType` 'H' | 'V' | 'R' | 'L': Transponder polarization e.g. H - (Horizontally Polarized) Perpendicular to Earth's surface, V - (Vertically Polarized) Parallel to Earth's surface, L - (Left Hand Circularly Polarized) Rotating left relative to the earth's surface, R - (Right Hand Circularly Polarized) Rotating right relative to the earth's surface. - `channel` integer: Channel of the RFObservation record. - `powerOverNoise` number, double: Measured carrier power over noise (decibel watts per hertz). - `nominalPowerOverNoise` number, double: Expected carrier power over noise (decibel watts per hertz). - `bandwidth` number, double: Measured bandwidth in hertz. - `nominalBandwidth` number, double: Expected bandwidth in hertz. - `resolutionBandwidth` number, double: Resolution bandwidth in hertz. - `videoBandwidth` number, double: Video bandwidth in hertz. - `eirp` number, double: Measured Equivalent Isotopically Radiated Power in decibel watts. - `nominalEirp` number, double: Expected Equivalent Isotopically Radiated Power in decibel watts. - `minPSD` number, double: Minimum measured PSD value of the trace in decibel watts. - `maxPSD` number, double: Maximum measured PSD value of the trace in decibel watts. - `frequencyShift` number, double: Frequency Shift of the RFObservation record. - `peak` boolean: Peak of the RFObservation record. - `antennaName` string: Antenna name of the RFObservation record. - `detectionStatus` string: Detection status (e.g. DETECTED, CARRIER_ACQUIRING, CARRIER_DETECTED, NOT_DETECTED, etc). - `collectionMode` string: Collection mode (e.g. CONTINUOUS, MANUAL, NEIGHBORHOOD_WATCH, DIRECTED_SEARCH, SPOT_SEARCH, SURVEY, etc). - `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. - `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. - `noisePwrDensity` number, double: Noise power density, in decibel watts per hertz. - `carrierStandard` string: Carrier standard (e.g. DVB-S2, 802.11g, etc.). - `modulation` string: Transponder modulation (e.g. Auto, QPSK, 8PSK, etc). - `innerCodingRate` integer: Inner forward error correction rate: 0 = Auto, 1 = 1/2, 2 = 2/3, 3 = 3/4, 4 = 5/6, 5 = 7/8, 6 = 8/9, 7 = 3/5, 8 = 4/5, 9 = 9/10, 15 = None. - `outerCodingRate` integer: Outer forward error correction rate: 0 = Auto, 1 = 1/2, 2 = 2/3, 3 = 3/4, 4 = 5/6, 5 = 7/8, 6 = 8/9, 7 = 3/5, 8 = 4/5, 9 = 9/10, 15 = None. - `transmitFilterType` string: Transmit pulse shaping filter type (e.g. RRC). - `transmitFilterRollOff` number, double: Transmit pulse shaping filter roll-off value. - `symbolToNoiseRatio` number, double: Symbol to noise ratio, in decibels. - `bitErrorRate` number, double: The ratio of bit errors per number of received bits. - `origMarking` string: Original security marking that the data was marked with. - `origCountry` string: Country of origin in which the data was originally posted. - `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. - `descriptor` string: Optional source-provided and searchable metadata or descriptor of the data. - `url` string: Optional URL containing additional information on this observation. ## 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-09-26** `45631f9bb3f0`: 2 info - added the optional property `items/origCountry` to the response with the `200` status - added the optional property `items/origMarking` 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`: 6 info - api operation id `findAllWithStream_15` 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/elevationMeasured` to the response with the `200` status - …2 more [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/rfobservation/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)