Report and Activity

POST /udl/emireport

Changed on

Service operation to take a single EMIReport record as a POST body and ingest into the database. A specific role is required to perform this service operation. Please contact the UDL team for assistance.

Request

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

Request body

idstring

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

classificationMarkingstring required

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

reportTypestring required

The type of Electromagnetic Interference (EMI) being reported (GPS, SATCOM, TERRESTRIAL).

reportTimestring date-time required

The reporting time of this EMI Report record, in ISO 8601 UTC format, with millisecond precision.

reportIdstring required

User generated report identifier. This ID should remain the same on subsequent updates to this report.

statusstring

The reporting status (INITIAL, UPDATE, RESOLVED) of this EMI issue.

emiTypestring

The type of EMI (i.e. BARRAGE, CARRIER WAVE, etc.), if known.

affActivitystring

The specific type of activity affected by the reported EMI (e.g. UPLINK, DOWNLINK, HF COMM, etc.).

startTimestring date-time required

The EMI start time in ISO 8601 UTC format, with millisecond precision.

endTimestring date-time

The EMI end time in ISO 8601 UTC format, with millisecond precision. The endTime may be excluded if EMI is ongoing.

persistencestring

The persistence status (e.g. CONTINUOUS, INTERMITTENT, RANDOM, etc.) of the EMI.

aorstring

The Area Of Responsibility (AOR), Organization, or Combatant Command under which the reported EMI pertains (AFRICOM, CENTCOM, EUCOM, INDOPACOM, NORTHCOM, SOCOM, SOUTHCOM, SPACECOM, STRATCOM, TRANSCOM, UNKNOWN).

respServicestring

The responsible service branch under which this EMI falls (AIR FORCE, ARMY, COAST GUARD, MARINES, NAVY).

bandstring

The band (EHF, SHF, UHF, etc.) affected by the EMI.

frequencynumber double

The affected frequency, in MHz.

highAffectedFrequencynumber double

The highest affected frequency, in MHz.

gpsFreqstring

The affected GPS Frequency (L1, L2, etc.).

gpsEncryptedboolean

Flag indicating whether encryption is in use on the affected GPS frequency.

channelstring

The channel affected by the EMI.

rcvrTypestring

The affected antenna type (e.g. DISH, OMNI, PHASED ARRAY, etc.) experiencing the EMI.

rcvrGainnumber double

The gain setting of the affected receiver, in decibels (dB).

rcvrDemodstring

The demodulation method (e.g. AM, FM, FSK, PSK, etc.) setting of the affected receiver.

beamPatternstring

The beam pattern in use.

interceptboolean

Flag indicating whether the EMI is a decipherable intercept over the affected receiver. Additional information may be included in the description field content of this record.

interceptTypestring

The type of transmission being intercepted (e.g. VOICE, etc.). Applicable when intercept = TRUE.

interceptLangstring

The language heard over the intercepted source. Applicable when interceptType = VOICE.

intSrcEncryptedboolean

Flag indicating whether the interfering source is encrypted.

intSrcModulationstring

The modulation method (e.g. AM, FM, FSK, PSK, etc.) of the interfering source, if known.

intSrcCentFreqnumber double

The center frequency, in MHz, of the interfering source, if known.

intSrcBandwidthnumber double

The bandwidth, in MHz, of the interfering source, if known.

intSrcAmplitudenumber double

The relative amplitude, in decibels (dB), of the interfering source, if known.

chanPirateboolean

Flag indicating whether this interference appears to be illegally passing traffic over a known channel.

rcvrLocationstring

Description of the affected receiver location.

latnumber double

WGS-84 latitude of the affected receiver, represented as -90 to 90 degrees (negative values south of equator).

lonnumber double

WGS-84 longitude of the affected receiver, represented as -180 to 180 degrees (negative values west of Prime Meridian).

altnumber double

Altitude of the affected receiver, expressed in meters above WGS-84 ellipsoid.

geoLocErrEllpnumber[]

Confidence ellipse centered about the detection location [semi-major axis (m), semi-minor axis (m), orientation (deg) measured clockwise (0 - 360) from true North].

milGridstring

The Military Grid Reference System (MGRS) location of the affected receiver. The Military Grid Reference System is the geocoordinate standard used by NATO militaries for locating points on Earth. The MGRS is derived from the Universal Transverse Mercator (UTM) grid system and the Universal Polar Stereographic (UPS) grid system, but uses a different labeling convention. The MGRS is used as geocode for the entire Earth. Example of a milgrid coordinate, or grid reference, would be 4QFJ12345678, which consists of three parts:

4Q (grid zone designator, GZD) FJ (the 100,000-meter square identifier) 12345678 (numerical location; easting is 1234 and northing is 5678, in this case specifying a location with 10 m resolution).

killBoxstring

The location of the affected receiver, reported as a kill box.

victimCountryCodestring

The country code in which the EMI occurred or is occurring. This value is typically the ISO 3166 Alpha-2 two-character country code, however it can also represent various consortiums that do not appear in the ISO document. The code must correspond to an existing country in the UDL’s country API. Call udl/country/{code} to get any associated FIPS code, ISO Alpha-3 code, or alternate code values that exist for the specified country code.

victimAltCountrystring

The alternate country identifier in which the EMI occurred or is occurring. Specifies an alternate country code if the data provider code is not part of an official Country Code standard such as ISO-3166 or FIPS.

platformstring

The name or identifier of the affected platform.

systemstring

The name or identifier of the affected system.

satNamestring

The name of the spacecraft whose link is being affected by the EMI.

satNointeger

Satellite/Catalog number of the affected OnOrbit object.

idOnOrbitstring

Unique identifier of the affected on-orbit object. For the public catalog, the idOnOrbit is typically the satellite number as a string, but may be a UUID for analyst or other unknown or untracked satellites.

origObjectIdstring

Optional identifier provided by the reporting source to indicate the affected object of this report. This may be an internal identifier and not necessarily map to a valid satellite number.

linkstring

The name or identifier of the affected link.

satTransponderIdstring

The name or identifier of the affected sat transponder.

satUplinkFrequencynumber double

The uplink frequency, in MHz, of the impacted link.

satUplinkPolarizationstring

The uplink polarization e.g. H - (Horizontally Polarized), V - (Vertically Polarized), L - (Left Hand Circularly Polarized), R - (Right Hand Circularly Polarized).

satDownlinkFrequencynumber double

The downlink frequency, in MHz, of the impacted link.

satDownlinkPolarizationstring

The downlink polarization e.g. H - (Horizontally Polarized), V - (Vertically Polarized), L - (Left Hand Circularly Polarized), R - (Right Hand Circularly Polarized).

satcomPrioritystring

The priority (LOW, MEDIUM, HIGH) of the affected SATCOM.

descriptionstring

Text description of the EMI particulars and other supporting information which may be relevant to the cause and/or possible resolution of the issue.

actionsTakenstring

Actions(s) taken to troubleshoot, mitigate, work-around, and/or resolve the EMI impacts.

requestAssistboolean required

Flag indicating whether assistance is being requested to address this EMI.

isrboolean required

Flag indicating whether the affected mission is an ISR mission.

isrCollectionImpactboolean

Flag indicating whether this EMI is impacting ISR collection.

victimFuncImpactsstring

The victim functional impacts (e.g. C2, COMM DATA LINK, ISR SENSOR, PNT, etc.).

supportedISRRolestring

The ISR role of the impacted asset.

victimReactionstring

The victim reaction (e.g. LOITER ORBIT, RETASK ASSET, RETURN TO BASE, TROUBLESHOOT, etc.).

dneImpactstring

Duration, Nature, Extent of impact.

victimPOCNamestring

The Point of Contact (POC) for this EMI Report.

victimPOCUnitstring

The Unit or Organization of the reporting POC.

victimPOCPhonestring

The phone number of the reporting POC, represented as digits only, no spaces or special characters.

victimPOCMailstring

The e-mail contact of the reporting POC.

tagsstring[]

Optional array of provider/source specific tags for this data, where each element is no longer than 32 characters, used for implementing data owner conditional access controls to restrict access to the data. Should be left null by data providers unless conditional access controls are coordinated with the UDL team.

transactionIdstring

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

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.

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.

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.

origNetworkstring

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

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.

Example request

{
  "id": "026dd511-8ba5-47d3-9909-836149f87686",
  "classificationMarking": "U",
  "reportType": "SATCOM",
  "reportTime": "2025-01-07T21:47:40.438Z",
  "reportId": "REPORT-ID",
  "status": "INITIAL",
  "emiType": "BARRAGE",
  "affActivity": "UPLINK",
  "startTime": "2025-01-07T20:16:03.989Z",
  "endTime": "2025-01-07T21:30:51.672Z",
  "persistence": "CONTINUOUS",
  "aor": "NORTHCOM",
  "respService": "ARMY",
  "band": "SHF",
  "frequency": 1575.42,
  "highAffectedFrequency": 1725,
  "gpsFreq": "L1",
  "channel": "10C-10CU",
  "rcvrType": "OMNI",
  "rcvrGain": 23.7,
  "rcvrDemod": "FSK",
  "beamPattern": "MAIN LOBE",
  "interceptType": "VOICE",
  "interceptLang": "ENGLISH",
  "intSrcModulation": "FSK",
  "intSrcCentFreq": 485.7,
  "intSrcBandwidth": 30,
  "intSrcAmplitude": 0.275,
  "rcvrLocation": "FORT CARSON GARAGE",
  "lat": 38.7375,
  "lon": -104.7889,
  "alt": 1750,
  "geoLocErrEllp": [
    1300,
    700,
    35
  ],
  "milGrid": "4QFJ12345678",
  "killBox": "7F9SW",
  "victimCountryCode": "US",
  "victimAltCountry": "US",
  "platform": "CVN-78",
  "system": "RADIO",
  "satName": "MILSTAR DFS-3",
  "satNo": 25724,
  "idOnOrbit": "25724",
  "origObjectId": "25724",
  "link": "SPOT-21",
  "satTransponderId": "36097-8433-10C",
  "satUplinkFrequency": 44532.1,
  "satUplinkPolarization": "H",
  "satDownlinkFrequency": 47432.5,
  "satDownlinkPolarization": "V",
  "satcomPriority": "HIGH",
  "description": "Interference on channel",
  "actionsTaken": "verified connections, cables and antenna pointing angles",
  "requestAssist": true,
  "isr": true,
  "victimFuncImpacts": "C2",
  "supportedISRRole": "IMAGERY",
  "victimReaction": "TROUBLESHOOT",
  "dneImpact": "Text description of the duration, nature and extent (DNE) of the impact.",
  "victimPOCName": "Robert Smith",
  "victimPOCUnit": "4th Engineering Battalion",
  "victimPOCPhone": "7198675309",
  "victimPOCMail": "bob@jammer.com",
  "tags": [
    "TAG1",
    "TAG2"
  ],
  "transactionId": "TRANSACTION-ID",
  "createdAt": "2018-01-01T16:00:00.123Z",
  "createdBy": "some.user",
  "sourceDL": "AXE",
  "source": "Bluestaq",
  "origin": "THIRD_PARTY_DATASOURCE",
  "origNetwork": "OPS1",
  "dataMode": "TEST"
}

Response

Success

Changes

Some revisions have not been checked yet.