--- title: "POST /udl/mti/createBulk" method: POST path: "/udl/mti/createBulk" tags: ["MTI"] --- # POST /udl/mti/createBulk `POST /udl/mti/createBulk` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/mti/createBulk` - Auth: none declared Service operation intended for initial integration only, to take a list of Moving Target Indicator (MTI) records as a POST body and ingest into the database. This operation is not intended to be used for automated feeds into UDL. Data providers should contact the UDL team for specific role assignments and for instructions on setting up a permanent feed through an alternate mechanism. ## Request body - MtiIngest[] - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `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. - `id` string: Unique identifier of the record, auto-generated 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. - `createdBy` string: Application user who created the row in the database, auto-populated by the system. - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system. - `p3` string: Nationality of the platform providing the data. - `p6` string: Control / handling marking. - `p7` string: Data record exercise indicator. - `p8` string: ID of the platform providing the data (tail number for air platform, name and numerical designator for space-based platforms). - `p9` integer: Integer field, assigned by the platform, that uniquely identifies the mission for the platform. - `p10` integer: A platform-assigned number identifying the specific request or task that pertains to all Dwell, HRR, and Range-Doppler segments in the packet. Job ID is unique within a mission. - `missions` MtiMissionIngest[]: A platform-assigned number identifying the specific request or task that pertains to all Dwell, HRR, and Range-Doppler segments in the packet. Job ID is unique within a mission. - `m1` string: The mission plan id. - `m2` string: Unique identification of the flight plan. - `m3` string: Platform type that originated the data. - `m4` string: Identification of the platform variant, modifications, etc. - `msnRefTs` string, date: Mission origination date. - `dwells` MtiDwellIngest[]: A platform-assigned number identifying the specific request or task that pertains to all Dwell, HRR, and Range-Doppler segments in the packet. Job ID is unique within a mission. - `d2` integer: Sequential count of a revisit of the bounding area in the last sent Job Definition Segment, where a Revisit Index of '0' indicates the first revisit. - `d3` integer: Temporally sequential count of a dwell within the revisit of a particular bounding area for a given job ID. - `d4` boolean: Flag indicating the last dwell of the revisit. - `d5` integer: Count of the total number of targets reported during this dwell and sent in this Dwell Segment. - `d6` integer: Elapsed time, expressed in milliseconds, from midnight at the beginning of the day specified in the Reference Time fields (missionRefTime) of the Mission Segment. - `d7` number, double: North-South position of the sensor at the temporal center of the dwell, in degrees. - `d8` number, double: The East-West position of the sensor at the temporal center of the dwell, in degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian. - `d9` integer: The altitude of the sensor at temporal center of the dwell, above the WGS 84 ellipsoid, expressed in centimeters. - `d10` number, double: Factor which modifies the value of the reported target latitude (Delta Latitude, field D32.4). - `d11` number, double: Factor which modifies the value of the reported target longitude (Delta Longitude, field D32.5). - `d12` integer: Standard deviation in the estimated horizontal sensor location at the time of the dwell, measured along the sensor track direction (field D15), in centimeters. - `d13` integer: Standard deviation in the estimated horizontal sensor location at the time of the dwell, measured orthogonal to the sensor track direction (field D15), in centimeters. - `d14` integer: Standard deviation of the sensor altitude estimate (field D9), in centimeters. - `d15` number, double: Ground track of the sensor at the time of the dwell, as the angle in degrees (clockwise) from True North. - `d16` integer: Ground speed of the sensor at the time of the dwell, in millimeters per second. - `d17` integer: Velocity of the sensor in the vertical direction, in decimeters per second. - `d18` integer: Standard deviation of the estimate of the sensor track, in degrees. - `d19` integer: Standard deviation of estimate of the sensor speed, in millimeters per second. - `d20` integer: Standard deviation of estimate of the sensor vertical velocity, expressed in centimeters per second. - `d21` number, double: Heading of the platform at the time of the dwell, as the angle in degrees (clockwise) from True North to the roll axis of the platform. - `d22` number, double: Pitch angle of the platform at the time of the dwell, in degrees. - `d23` number, double: Roll angle of the platform at the time of the dwell, in degrees. - `d24` number, double: The North-South position of the center of the dwell area, expressed as degrees North (positive) or South (negative) of the Equator. - `d25` number, double: The East-West position of the center of the dwell area, expressed as degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian. - `d26` number, double: Distance on the earth surface, expressed in kilometers, from the near edge to the center of the dwell area. - `d27` number, double: For dwell based radars, one-half of the 3-dB beamwidth. For non-dwell based radars, the angle between the beginning of the dwell to the center of the dwell. Measured in degrees. - `d28` number, double: Rotation of the sensor broadside face about the local vertical axis of the platform, in degrees. - `d29` number, double: Rotation angle of the sensor about the transverse axis of the sensor broadside, in degrees. - `d30` number, double: Rotation angle of the sensor about the transverse axis of the sensor broadside, in degrees. - `d31` integer: Minimum velocity component, along the line of sight, which can be detected by the sensor, in decimeters per second. - `d32` MtiTargetReportIngest[]: Minimum velocity component, along the line of sight, which can be detected by the sensor, in decimeters per second. - `d32_1` integer: Sequential count of this MTI report within the dwell. - `d32_2` number, double: The North-South position of the reported detection, expressed as degrees North (positive) or South (negative) of the Equator. - `d32_3` number, double: The East-West position of the reported detection, expressed as degrees East (positive) from the Prime Meridian. - `d32_4` integer: The North-South position of the reported detection, expressed as degrees North (positive) or South (negative) from the Dwell Area Center Latitude. - `d32_5` integer: The East-West position of the reported detection, expressed as degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian from the Dwell Area Center Longitude. - `d32_6` integer: Height of the reported detection, referenced to its position above the WGS 84 ellipsoid, in meters. - `d32_7` integer: The component of velocity for the reported detection, expressed in centimeters per second, corrected for platform motion, along the line of sight between the sensor and the reported detection, where the positive direction is away from the sensor. - `d32_8` integer: The target wrap velocity permits trackers to un-wrap velocities for targets with line-of-sight components large enough to exceed the first velocity period. Expressed in centimeters/sec. - `d32_9` integer: Estimated signal-to-noise ratio (SNR) of the target return, in decibels. - `d32_10` string: The classification of the target (i.e. vehicle, aircraft, …). - `d32_11` integer: Estimated probability that the target classification field is correctly classified. - `d32_12` integer: Standard deviation of the estimated slant range of the reported detection, in centimeters. - `d32_13` integer: Standard deviation of the position estimate, in the cross-range direction, of the reported detection, in decimeters. - `d32_14` integer: Standard deviation of the estimated geodetic height, in meters. - `d32_15` integer: Standard deviation of the measured line-of-sight velocity component, in centimeters per second. - `d32_16` integer: The Truth Tag- Application is the Application Field truncated to 8 bits, from the Entity State Protocol Data Unit (PDU) used to generate the MTI Target. - `d32_17` integer: The Truth Tag - Entity is the Entity Field from the Entity State PDU used to generate the MTI Target. - `d32_18` integer: Estimated radar cross section of the target return, in half-decibels. - `dwellts` string, date-time: Dwell timestamp in ISO8601 UTC format. - `hrrs` MtiHRRIngest[]: A platform-assigned number identifying the specific request or task that pertains to all Dwell, HRR, and Range-Doppler segments in the packet. Job ID is unique within a mission. - `h2` integer: Sequential count of a revisit of the bounding area for a given job ID. - `h3` integer: Sequential count of a dwell within the revisit of a particular bounding area for a given job ID. - `h4` boolean: Flag to indicate the last dwell of the revisit. - `h5` integer: Sequential index of the associated MTI Report. - `h6` integer: Number of Range Doppler pixels that exceed target scatterer threshold and are reported in this segment. - `h7` integer: Number of Range Bins/Samples in a Range Doppler Chip. - `h8` integer: Number of Doppler bins in a Range-Doppler chip. - `h9` integer: The Peak Scatter returns the maximum power level (e.g. in milliwatts, or dBm) registered by the sensor. - `h10` integer: Detection threshold used to isolate significant target scatterer pixels, expressed as power relative to clutter mean in negative quarter-decibels. - `h11` number, double: 3dB range impulse response of the radar, expressed in centimeters. - `h12` number, double: Slant Range pixel spacing after over sampling, expressed in centimeters. - `h13` number, double: 3dB Doppler resolution of the radar, expressed in Hertz. - `h14` number, double: Doppler pixel spacing after over sampling, expressed in Hertz. - `h15` number, double: Center Frequency of the radar in GHz. - `h16` string: Enumeration table denoting the compression technique used. - `h17` string: Enumeration table indicating the spectral weighting used in the range compression process. - `h18` string: Enumeration table indicating the spectral weighting used in the cross-range or Doppler compression process. - `h19` number, double: Initial power of the peak scatterer, expressed in dB. - `h20` integer: RCS of the peak scatterer, expressed in half-decibels (dB/2). - `h21` integer: When the RDM does not correlate to a single MTI report index or when the center range bin does not correlate to the center of the dwell; provide the range sample offset in meters from Dwell Center (positive is away from the sensor) of the first scatterer record. - `h22` integer: When the RDM does not correlate to a single MTI report index or the center doppler bin does not correlate to the doppler centroid of the dwell; Doppler sample value in Hz of the first scatterer record. - `h23` string: Enumeration field which designates the type of data being delivered. - `h24` string: Flag field to indicate the additional signal processing techniques applied to the data. - `h27` integer: Number of pixels in the range dimension of the chip. - `h28` integer: Distance from Range Bin to closest edge in the entire chip, expressed in centimeters. - `h29` integer: Relative velocity to skin line. - `h30` integer: Computed object length based upon HRR profile, in meters. - `h31` integer: Standard deviation of estimate of the object length, expressed in meters. - `h32` MtiHRRScattererIngest[]: Standard deviation of estimate of the object length, expressed in meters. - `h32_1` integer: Scatterer’s power magnitude. - `h32_2` integer: Scatterer’s complex phase, in degrees. - `h32_3` integer: Scatterer’s Range index relative to Range-Doppler chip, where increasing index equates to increasing range. - `h32_4` integer: Scatterer’s Doppler index relative to Range-Doppler chip, where increasing index equates to increasing Doppler. - `jobDefs` MtiJobDefinitionIngest[]: A platform-assigned number identifying the specific request or task that pertains to all Dwell, HRR, and Range-Doppler segments in the packet. Job ID is unique within a mission. - `j1` integer: A platform assigned number identifying the specific request or task to which the specific dwell pertains. - `j2` string: The type of sensor or the platform. - `j3` string: Identifier of the particular variant of the sensor type. - `j4` integer: Flag field indicating whether filtering has been applied to the targets detected within the dwell area. - `j5` integer: Priority of this tasking request relative to all other active tasking requests scheduled for execution on the specified platform. - `j6` number, double: North-South position of the first corner (Point A) defining the area for sensor service, expressed as degrees North (positive) or South (negative) of the Equator. - `j7` number, double: East-West position of the first corner (Point A) defining the area for sensor service, expressed as degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian. - `j8` number, double: North-South position of the second corner (Point B) defining the area for sensor service, expressed as degrees North (positive) or South (negative) of the Equator. - `j9` number, double: East-West position of the second corner (Point B) defining the area for sensor service, expressed as degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian. - `j10` number, double: North-South position of the third corner (Point C) defining the area for sensor service, expressed as degrees North (positive) or South (negative) of the Equator. - `j11` number, double: East-West position of the third corner (Point C) defining the area for sensor service, expressed as degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian. - `j12` number, double: North-South position of the fourth corner (Point D) defining the area for sensor service, expressed as degrees North (positive) or South (negative) of the Equator. - `j13` number, double: East-West position of the fourth corner (Point D) defining the area for sensor service, expressed as degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian. - `j14` string: Mode in which the radar will operate for the given job ID. - `j15` integer: The nominal revisit interval for the job ID, expressed in deciseconds. Value of zero, indicates that the sensor is not revisiting the previous area. - `j16` integer: Nominal estimate of the standard deviation in the estimated horizontal (along track) sensor location, expressed in decimeters. measured along the sensor track direction defined in the Dwell segment. - `j17` integer: Nominal estimate of the standard deviation in the estimated horizontal sensor location, measured orthogonal to the track direction, expressed in decimeters. - `j18` integer: Nominal estimate of the standard deviation of the measured sensor altitude, expressed in decimeters. - `j19` integer: Standard deviation of the estimate of sensor track heading, expressed in degrees. - `j20` integer: Nominal standard deviation of the estimate of sensor speed, expressed in millimeters per second. - `j21` integer: Nominal standard deviation of the slant range of the reported detection, expressed in centimeters. - `j22` number, double: Nominal standard deviation of the measured cross angle to the reported detection, expressed in degrees. - `j23` integer: Nominal standard deviation of the velocity line-of-sight component, expressed in centimeters per second. - `j24` integer: Nominal minimum velocity component along the line of sight, which can be detected by the sensor, expressed in decimeters per second. - `j25` integer: Nominal probability that an unobscured ten square-meter target will be detected within the given area of surveillance. - `j26` integer: The expected density of False Alarms (FA), expressed as the negative of the decibel value. - `j27` string: The terrain elevation model used for developing the target reports. - `j28` string: The geoid model used for developing the target reports. - `freeTexts` MtiFreeTextIngest[]: A platform-assigned number identifying the specific request or task that pertains to all Dwell, HRR, and Range-Doppler segments in the packet. Job ID is unique within a mission. - `f1` string: The originator of the Free Text message. - `f2` string: The recipient for which the Free Text message is intended. - `f3` string: Free text data message. - `platformLocs` MtiPlatformLocationIngest[]: A platform-assigned number identifying the specific request or task that pertains to all Dwell, HRR, and Range-Doppler segments in the packet. Job ID is unique within a mission. - `l1` integer: Elapsed time, expressed in milliseconds, from midnight at the beginning of the day specified in the Reference Time fields of the Mission Segment to the time the report is prepared. - `l2` number, double: North-South position of the platform at the time the report is prepared, expressed as degrees North (positive) or South (negative) of the Equator. - `l3` number, double: East-West position of the platform at the time the report is prepared, expressed as degrees East (positive) from the Prime Meridian. - `l4` integer: Altitude of the platform at the time the report is prepared, referenced to its position above the WGS-84 ellipsoid, in centimeters. - `l5` number, double: Ground track of the platform at the time the report is prepared, expressed as the angle in degrees (clockwise) from True North. - `l6` integer: Ground speed of the platform at the time the report is prepared, expressed as millimeters per second. - `l7` integer: Velocity of the platform in the vertical direction, expressed as decimeters per second. - `platlocts` string, date-time: Platform location timestamp in ISO8601 UTC format. - `jobRequests` MtiJobRequestIngest[]: A platform-assigned number identifying the specific request or task that pertains to all Dwell, HRR, and Range-Doppler segments in the packet. Job ID is unique within a mission. - `r1` string: The requestor of the sensor service. - `r2` string: Identifier for the tasking message sent by the requesting station. - `r3` integer: The priority of the request relative to other requests originated by the requesting station. - `r4` number, double: North-South position of the first corner (Point A) defining the requested area for service, expressed as degrees North (positive) or South (negative) of the Equator. - `r5` number, double: East-West position of the first corner (Point A) defining the requested area for service, expressed as degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian. - `r6` number, double: North-South position of the second corner (Point B) defining the requested area for service, expressed as degrees North (positive) or South (negative) of the Equator. - `r7` number, double: East-West position of the second corner (Point B) defining the requested area for service, expressed as degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian. - `r8` number, double: North-South position of the third corner (Point C) defining the requested area for service, expressed as degrees North (positive) or South (negative) of the Equator. - `r9` number, double: East-West position of the third corner (Point C) defining the requested area for service, expressed as degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian. - `r10` number, double: North-South position of the fourth corner (Point D) defining the requested area for service, expressed as degrees North (positive) or South (negative) of the Equator. - `r11` number, double: East-West position of the fourth corner (Point D) defining the requested area for service, expressed as degrees East (positive, 0 to 180) or West (negative, 0 to -180) of the Prime Meridian. - `r12` string: Identifies the radar mode requested by the requestor. - `r13` integer: Specifies the radar range resolution requested by the requestor, expressed in centimeters. - `r14` integer: Specifies the radar cross-range resolution requested by the requestor, expressed in decimeters. - `jobReqEst` string, date-time: Specifies the Earliest Start Time for which the service is requested. Composite of fields R15-R20. - `r21` integer: Specifies the maximum time from the requested start time after which the request is to be abandoned, expressed in seconds. - `r22` integer: Specifies the time duration for the radar job, measured from the actual start of the job, expressed in seconds. - `r23` integer: Specifies the revisit interval for the radar job, expressed in deciseconds. - `r24` string: the type of sensor or the platform. - `r25` string: The particular variant of the sensor type. - `r26` boolean: Flag field indicating that it is an initial request (flag = 0) or the desire of the requestor to cancel (flag = 1) the requested job. - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. ## Response `204` 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 breaking - the `items/createdBy` request property's minLength was increased from `0` to `1` - **2025-04-16** `75f764c843a9`: 31 breaking, 2 info - request body became required - the `items/dwells/items/d17` request property format changed from `int32` to `int8` - the `items/dwells/items/d18` request property format changed from `int32` to `int8` - the `items/dwells/items/d31` request property format changed from `int32` to `int16` - …29 more [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/mti/createBulk/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)