POST /udl/operatingunit
Changed onService operation to take a single Operatingunit as a POST body and ingest into the database. Operatingunit defines a unit or organization which operates or controls a space-related Entity. A specific role is required to perform this service operation. Please contact the UDL team for assistance.
Request
- Base URLhttps://unifieddatalibrary.com
- URLhttps://unifieddatalibrary.com/udl/operatingunit
- Authnone declared
Request body
Unique identifier of the record, auto-generated by the system.
Classification marking of the data in IC/CAPCO Portion-marked format.
Unique identifier of the operating unit record from the originating system.
Name of the operating unit.
Description of the operating unit.
Unique identifier of the location record for this operating unit.
Unique identifier of the contact for this operating unit.
Unique identifier of the organization record for this operating unit.
An optional identifier for this operating unit that may be composed from items such as the originating organization, allegiance, one-up number, etc.
The DoD Standard country code designator for the country or political entity to which the operating unit geographic coordinates reside . This field will be set to "OTHR" if the source value does not match a UDL country code value (ISO-3166-ALPHA-2).
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. This field will be set to the value provided by the source and should be used for all Queries specifying a Country Code.
World Aeronautical Chart identifier for the area in which a designated operating unit is located.
The Degree to which an operating unit is ready to perform the overall operational mission(s) for which it was organized and equipped. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
The physical manner of being or state of existence of the operating unit. A physical condition that must be considered in the determining of a course of action. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
Availability of the operating unit relative to its condition. Indicates the reason the operating unit is not fully operational. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
The Intelligence Confidence Level or the Reliability/degree of confidence that the analyst has assigned to the data within this record. The numerical range is from 1 to 9 with 1 representing the highest confidence level.
Functional Production Area (FPA) under the Shared Production Program (SPP). Producers are defined per country per FPA. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
Estimated identity of the Site (ASSUMED FRIEND, FRIEND, HOSTILE, FAKER, JOKER, NEUTRAL, PENDING, SUSPECT, UNKNOWN):
ASSUMED FRIEND: Track assumed to be a friend due to the object characteristics, behavior, and/or origin.
FRIEND: Track object supporting friendly forces and belonging to a declared friendly nation or entity.
HOSTILE: Track object belonging to an opposing nation, party, group, or entity deemed to contribute to a threat to friendly forces or their mission due to its behavior, characteristics, nationality, or origin.
FAKER: Friendly track, object, or entity acting as an exercise hostile.
JOKER: Friendly track, object, or entity acting as an exercise suspect.
NEUTRAL: Track object whose characteristics, behavior, nationality, and/or origin indicate that it is neither supporting nor opposing friendly forces or their mission.
PENDING: Track object which has not been evaluated.
SUSPECT: Track object deemed potentially hostile due to the object characteristics, behavior, nationality, and/or origin.
UNKNOWN: Track object which has been evaluated and does not meet criteria for any standard identity.
The DoD Standard country code designator for the country or political entity to which the operating unit owes its allegiance. This field will be set to "OTHR" if the source value does not match a UDL country code value (ISO-3166-ALPHA-2).
Specifies an alternate allegiance code if the data provider code is not part of an official Country Code standard such as ISO-3166 or FIPS. This field will be set to the value provided by the source and should be used for all Queries specifying allegiance.
Location name for the coordinates.
Indicates the reason that the operating unit is at that location. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
An aggregation of military units within a single service (i.e., ARMY, AIR FORCE, etc.) which operates under a single authority to accomplish a common mission. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
The specific name for a given force. For example, Force = ADF (Air Defense Force) and Force Name = Army Air Defense Force.
Principal combat-related role that an operating unit is organized, structured and equipped to perform. Or, the specialized military or paramilitary branch in which an individual serves, their specialization. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
Indicates the principal type of mission that an operating unit is organized and equipped to perform. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
Indicates the principal specialty type of mission that an operating unit is organized and equipped to perform. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
This field contains a value indicating whether the record is a master unit record (True) or a detail record (False). Master records contain basic information that does not change over time for each unit that has been selected to be projected.
This field contains a value indicating whether the record is a stylized operating unit record (True) or a regular operating unit record (False). A stylized operating unit is a type of operating unit with one set of equipment that can be assigned to one or more superiors. A stylized operating unit is generally useful for lower echelon operating units where the number of operating units and types of equipment are equal for multiple organizations. In lieu of creating unique operating unit records for each operating unit, a template is created for the operating unit and its equipment. This template enables the user to assign the operating unit to multiple organizations.
Combat status of a divisional or equivalent operating unit. Currently, this data element applies only to operating units of the Former Soviet Union. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
Organizational level of the operating unit. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
Indicates the major group or level to which an echelon belongs. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
Naval fleet to which an operating unit is assigned. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
A code describing the amount of operating unit participation in a deployment. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
The country code of the observed flag flown.
A mathematical model of the earth used to calculate coordinates on a map. US Forces use the World Geodetic System 1984 (WGS 84), but also use maps by allied countries with local datums. The datum must be specified to ensure accuracy of coordinates. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
Indicates any of the magnitudes that serve to define the position of a point by reference to a fixed figure, system of lines, etc.
Pos. 1-2. Latitude Degrees [00-90]
Pos. 3-4. Latitude Minutes [00-59]
Pos. 5-6. Latitude Seconds [00-59]
Pos. 7-9. Latitude Thousandths Of Seconds [000-999]
Pos. 10. Latitude Hemisphere [NS]
Pos. 11-13. Longitude Degrees [00-180]
Pos. 14-15. Longitude Minutes [00-59]
Pos. 16-17. Longitude Seconds [00-59]
Pos. 18-20. Longitude Thousandths Of Seconds [000-999]
Pos. 21. Longitude Hemisphere [EW]
Pos. 1-21. Unknown Latitude and Unknown Longitude [000000000U000000000U]
Indicates the plus or minus error assessed against the method used to derive the coordinate.
WGS84 latitude of the location, in degrees. -90 to 90 degrees (negative values south of equator).
WGS84 longitude of the location, in degrees. -180 to 180 degrees (negative values west of Prime Meridian).
Ground elevation of the geographic coordinates referenced to (above or below) Mean Sea Level (MSL) vertical datum.
Indicates the confidence level expressed as a percent that a specific geometric spatial element, ELEVATION_MSL linear accuracy, has been vertically positioned to within a specified vertical accuracy.
Indicates the plus or minus error assessed against the method used to derive the elevation.
The distance between Mean Sea Level and a referenced ellipsoid.
Indicates the grid system used in the development of the milGrid coordinates. Values are:
UPS - Universal Polar System
UTM - Universal Transverse Mercator
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 an 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).
Universal Transverse Mercator (UTM) grid coordinates. Pos. 1-2, UTM Zone Column [01-60 Pos. 3, UTM Zone Row [C-HJ-NP-X] Pos. 4, UTM False Easting [0-9] Pos. 5-9, UTM Meter Easting [0-9][0-9][0-9][0-9][0-9] Pos. 10-11, UTM False Northing [0-9][0-9] Pos. 12-16, UTM Meter Northing [0-9][0-9][0-9][0-9][0-9].
Air Defense District (ADD) or Air Defense Area (ADA) in which the geographic coordinates reside.
Political subdivision in which the geographic coordinates reside. The specific usage and enumerations contained in this field may be found in the documentation provided in the referenceDoc field. If referenceDoc not provided, users may consult the data provider.
A standard scheme for symbol coding enabling the transfer, display and use of symbols and graphics among information systems, as per MIL-STD 2525B, and supported by the element AFFILIATION.
Indicates the importance of the operating unit to the OES or MIR system. This data element is restricted to update by DIA (DB-4). Valid values are: 0 - Does not meet criteria above 1 - Primary importance to system 2 - Secondary importance to system 3 - Tertiary importance to system O - Other. Explain in Remarks.
Validity and currency of the data in the record to be used in conjunction with the other elements in the record as defined by SOPs. Values are: A - Active I - Inactive K - Acknowledged L - Local Q - A nominated (NOM) or Data Change Request (DCR) record R - Production reduced by CMD decision W - Working Record.
Date on which the data in the record was last reviewed by the responsible analyst for accuracy and currency. This date cannot be greater than the current date.
Responsible Producer - Organization that is responsible for the maintenance of the record.
The reference documentiation that specifies the usage and enumerations contained in this record. If referenceDoc not provided, users may consult the data provider.
Time the row was created in the database, auto-populated by the system.
Application user who created the row in the database, auto-populated by the system.
Source of the data.
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.
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
{
"idOperatingUnit": "OPERATINGUNIT-ID",
"classificationMarking": "U",
"altOperatingUnitId": "32100000000021",
"name": "SOME_NAME",
"description": "Description of unit",
"idLocation": "LOCATION-ID",
"idContact": "CONTACT-ID",
"idOrganization": "ORGANIZATION-ID",
"unitIdentifier": "AZXAZ12345",
"countryCode": "IQ",
"altCountryCode": "IZ",
"wac": "0427",
"operStatus": "OPR",
"condition": "RDY",
"conditionAvail": "A",
"eval": 7,
"fpa": "EOB",
"ident": "FRIEND",
"allegiance": "OTHR",
"altAllegiance": "HL",
"locName": "LOCATION_NAME",
"locReason": "GR",
"force": "NV",
"forceName": "FORCE-NAME",
"functRole": "MIL",
"msnPrimary": "W6",
"msnPrimarySpecialty": "QK",
"masterUnit": true,
"stylizedUnit": true,
"divCat": "5",
"echelon": "SHIP",
"echelonTier": "68",
"fleetId": "A",
"deployStatus": "ND",
"flagFlown": "IZ",
"coordDatum": "WGS",
"coord": "340000000N0430000000E",
"coordDerivAcc": 12.345,
"lat": 45.23,
"lon": 179.1,
"elevMsl": 123.45,
"elevMslConfLvl": 50,
"elevMslDerivAcc": 12.34,
"geoidalMslSep": 12.34,
"milGridSys": "UTM",
"milGrid": "4QFJ12345678",
"utm": "19P4390691376966",
"airDefArea": "AL006",
"polSubdiv": "IZ07",
"symCode": "SOGPU----------",
"classRating": "1",
"recStatus": "A",
"reviewDate": "2008-06-10",
"resProd": "RT",
"referenceDoc": "Provider Reference Documentation",
"createdAt": "2018-01-01T16:00:00.123Z",
"createdBy": "some.user",
"source": "some.user",
"origin": "THIRD_PARTY_DATASOURCE",
"dataMode": "TEST"
}Response
Success
Changes
- info
api operation id
create_84removed and replaced with - info
the endpoint scheme security
BasicAuthwas removed from the API
- info
Some revisions have not been checked yet.