--- title: "POST /udl/emireport" method: POST path: "/udl/emireport" tags: ["Report and Activity"] --- # POST /udl/emireport `POST /udl/emireport` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/emireport` - Auth: none declared 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 body - EMIReportIngest: The EMI Report service supports the reporting, response, and resolution/mitigation for spectrum interference, and provides details regarding electromagnetic interference (EMI) detection, characterization, reporting, identification, geo-location, and resolution data for space-based and terrestrial systems. - `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. - `reportType` string, required: The type of Electromagnetic Interference (EMI) being reported (GPS, SATCOM, TERRESTRIAL). - `reportTime` string, date-time, required: The reporting time of this EMI Report record, in ISO 8601 UTC format, with millisecond precision. - `reportId` string, required: User generated report identifier. This ID should remain the same on subsequent updates to this report. - `status` string: The reporting status (INITIAL, UPDATE, RESOLVED) of this EMI issue. - `emiType` string: The type of EMI (i.e. BARRAGE, CARRIER WAVE, etc.), if known. - `affActivity` string: The specific type of activity affected by the reported EMI (e.g. UPLINK, DOWNLINK, HF COMM, etc.). - `startTime` string, date-time, required: The EMI start time in ISO 8601 UTC format, with millisecond precision. - `endTime` string, date-time: The EMI end time in ISO 8601 UTC format, with millisecond precision. The endTime may be excluded if EMI is ongoing. - `persistence` string: The persistence status (e.g. CONTINUOUS, INTERMITTENT, RANDOM, etc.) of the EMI. - `aor` string: 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). - `respService` string: The responsible service branch under which this EMI falls (AIR FORCE, ARMY, COAST GUARD, MARINES, NAVY). - `band` string: The band (EHF, SHF, UHF, etc.) affected by the EMI. - `frequency` number, double: The affected frequency, in MHz. - `highAffectedFrequency` number, double: The highest affected frequency, in MHz. - `gpsFreq` string: The affected GPS Frequency (L1, L2, etc.). - `gpsEncrypted` boolean: Flag indicating whether encryption is in use on the affected GPS frequency. - `channel` string: The channel affected by the EMI. - `rcvrType` string: The affected antenna type (e.g. DISH, OMNI, PHASED ARRAY, etc.) experiencing the EMI. - `rcvrGain` number, double: The gain setting of the affected receiver, in decibels (dB). - `rcvrDemod` string: The demodulation method (e.g. AM, FM, FSK, PSK, etc.) setting of the affected receiver. - `beamPattern` string: The beam pattern in use. - `intercept` boolean: 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. - `interceptType` string: The type of transmission being intercepted (e.g. VOICE, etc.). Applicable when intercept = TRUE. - `interceptLang` string: The language heard over the intercepted source. Applicable when interceptType = VOICE. - `intSrcEncrypted` boolean: Flag indicating whether the interfering source is encrypted. - `intSrcModulation` string: The modulation method (e.g. AM, FM, FSK, PSK, etc.) of the interfering source, if known. - `intSrcCentFreq` number, double: The center frequency, in MHz, of the interfering source, if known. - `intSrcBandwidth` number, double: The bandwidth, in MHz, of the interfering source, if known. - `intSrcAmplitude` number, double: The relative amplitude, in decibels (dB), of the interfering source, if known. - `chanPirate` boolean: Flag indicating whether this interference appears to be illegally passing traffic over a known channel. - `rcvrLocation` string: Description of the affected receiver location. - `lat` number, double: WGS-84 latitude of the affected receiver, represented as -90 to 90 degrees (negative values south of equator). - `lon` number, double: WGS-84 longitude of the affected receiver, represented as -180 to 180 degrees (negative values west of Prime Meridian). - `alt` number, double: Altitude of the affected receiver, expressed in meters above WGS-84 ellipsoid. - `geoLocErrEllp` number[]: Confidence ellipse centered about the detection location [semi-major axis (m), semi-minor axis (m), orientation (deg) measured clockwise (0 - 360) from true North]. - `milGrid` string: 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). - `killBox` string: The location of the affected receiver, reported as a kill box. - `victimCountryCode` string: 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. - `victimAltCountry` string: 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. - `platform` string: The name or identifier of the affected platform. - `system` string: The name or identifier of the affected system. - `satName` string: The name of the spacecraft whose link is being affected by the EMI. - `satNo` integer: Satellite/Catalog number of the affected OnOrbit object. - `idOnOrbit` string: 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. - `origObjectId` string: 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. - `link` string: The name or identifier of the affected link. - `satTransponderId` string: The name or identifier of the affected sat transponder. - `satUplinkFrequency` number, double: The uplink frequency, in MHz, of the impacted link. - `satUplinkPolarization` string: The uplink polarization e.g. H - (Horizontally Polarized), V - (Vertically Polarized), L - (Left Hand Circularly Polarized), R - (Right Hand Circularly Polarized). - `satDownlinkFrequency` number, double: The downlink frequency, in MHz, of the impacted link. - `satDownlinkPolarization` string: The downlink polarization e.g. H - (Horizontally Polarized), V - (Vertically Polarized), L - (Left Hand Circularly Polarized), R - (Right Hand Circularly Polarized). - `satcomPriority` string: The priority (LOW, MEDIUM, HIGH) of the affected SATCOM. - `description` string: Text description of the EMI particulars and other supporting information which may be relevant to the cause and/or possible resolution of the issue. - `actionsTaken` string: Actions(s) taken to troubleshoot, mitigate, work-around, and/or resolve the EMI impacts. - `requestAssist` boolean, required: Flag indicating whether assistance is being requested to address this EMI. - `isr` boolean, required: Flag indicating whether the affected mission is an ISR mission. - `isrCollectionImpact` boolean: Flag indicating whether this EMI is impacting ISR collection. - `victimFuncImpacts` string: The victim functional impacts (e.g. C2, COMM DATA LINK, ISR SENSOR, PNT, etc.). - `supportedISRRole` string: The ISR role of the impacted asset. - `victimReaction` string: The victim reaction (e.g. LOITER ORBIT, RETASK ASSET, RETURN TO BASE, TROUBLESHOOT, etc.). - `dneImpact` string: Duration, Nature, Extent of impact. - `victimPOCName` string: The Point of Contact (POC) for this EMI Report. - `victimPOCUnit` string: The Unit or Organization of the reporting POC. - `victimPOCPhone` string: The phone number of the reporting POC, represented as digits only, no spaces or special characters. - `victimPOCMail` string: The e-mail contact of the reporting POC. - `tags` string[]: 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. - `transactionId` string: Optional identifier to track a commercial or marketplace transaction executed to produce this data. - `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. - `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. - `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. - `origNetwork` string: 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. ## Response `201` Success ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `405`: Method Not Allowed - `415`: MediaType Unsupported - `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`: 1 info - endpoint added [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/emireport/post.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)