--- title: "POST /udl/sarobservation/createBulk" method: POST path: "/udl/sarobservation/createBulk" tags: ["Observation"] --- # POST /udl/sarobservation/createBulk `POST /udl/sarobservation/createBulk` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/sarobservation/createBulk` - Auth: none declared Service operation intended for initial integration only, to take a list of SAR observations 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 - SARObservationIngest[] - `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. - `idOnOrbit` string: Unique identifier of the spacecraft hosting the sensor associated with this collection. - `satNo` integer: Satellite/Catalog number of the spacecraft hosting the sensor associated with this collection. - `origObjectId` string: Optional identifier provided by the source to indicate the onorbit object hosting the sensor associated with this collection. This may be an internal identifier and not necessarily a valid satellite number. - `idSensor` string: Unique identifier of the reporting sensor. - `origSensorId` string: Optional identifier provided by the source to indicate the sensor for this collection. This may be an internal identifier and not necessarily a valid sensor ID. - `externalId` string: Optional ID from external systems. This field has no meaning within UDL and is provided as a convenience for systems that require tracking of an internal system generated ID. - `collectionId` string: Optional identifier to indicate the specific collection tasking which produced this observation. - `detectionId` string: Identifier of the specific detection within a collection which produced this observation. - `collectionStart` string, date-time, required: Collection start time in ISO 8601 UTC format with microsecond precision. - `collectionEnd` string, date-time, required: Collection end time in ISO 8601 UTC format with microsecond precision. - `centerTime` string, date-time: The datetime at the center point of the collection in ISO 8601 UTC format with microsecond precision. - `detectionStart` string, date-time: The detection start time in ISO 8601 UTC format, with microsecond precision. - `detectionEnd` string, date-time: The detection end time in ISO 8601 UTC format, with microsecond precision. - `dwellTime` number, double: The duration, in seconds, of this detection. - `orbitState` string: The orbital direction (ASCENDING, DESCENDING) of the platform during the collection. - `sarMode` string, required: Collection mode setting for this collection (e.g. AREA, SPOTLIGHT, STRIP, etc.). - `operatingBand` string: Name of the band containing operating frequency for the collection (e.g. C, E, EHF, HF, K, Ka, Ku, L, Q, S, SHF, UNK, UHF, V, VHF, VLF, W, X). See RFBandType for more details and descriptions of each band name. - `operatingFreq` number, double: The operating frequency, in Mhz, for the collection. - `snr` number, double: Signal to noise ratio, in dB. - `txPolarization` string: Transmit 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. - `rxPolarization` string: Receive 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. - `grazeAngle` number, double: The graze angle (also referred to as look angle) for the collection in degrees. - `incidenceAngle` number, double: The center incidence angle in degrees. - `squintAngle` number, double: The squint angle for the collection in degrees. - `pulseBandwidth` number, double: The bandwidth frequency of the pulse in Mhz. - `pulseDuration` number, double: The duration of a pulse in seconds. - `continuousSpotAngle` number, double: Required sweep angle for the continuous spot scene in degrees. - `slantRange` number, double: Slant distance from sensor to center point of imaging event in kilometers. - `nearRange` number, double: Specifies the closest range, in kilometers, from the flight path to target during the collection. - `farRange` number, double: Specifies the farthest range, in kilometers, from the flight path to target during the collection. - `swathLength` number, double: The length of the collection as projected on the ground in kilometers. - `area` string: Optional geographical region or polygon (lat/lon pairs) of the area surrounding the image event as projected on the ground. - `atext` string: Geographical region or polygon (lon/lat pairs), as depicted by the Well-Known Text representation of the geometry/geography, of the image as projected on the ground. WKT reference: https://www.opengeospatial.org/standards/wkt-crs. Ignored if included with a POST or PUT request that also specifies a valid 'area' field. - `agjson` string: Geographical region or polygon (lat/lon pairs), as depicted by the GeoJSON representation of the geometry/geography, of the image as projected on the ground. GeoJSON Reference: https://geojson.org/. Ignored if included with a POST or PUT request that also specifies a valid 'area' or 'atext' field. - `atype` string: Type of region as projected on the ground (POLYGON, POINT, LINE). - `andims` integer: Number of dimensions of the geometry depicted by region. - `asrid` integer: Geographical spatial_ref_sys for region. - `spacingRange` number, double: The pixel spacing in the range direction measured in meters. - `spacingAzimuth` number, double: The pixel spacing in the azimuth direction measured in meters. - `looksAzimuth` integer: The number of looks in the azimuth direction. - `looksRange` integer: The number of looks in the range direction. - `multilookNumber` number, double: Averages the input synthetic aperture radar (SAR) data by looks in range and azimuth to approximate square pixels, mitigates speckle, and reduces SAR tool processing time. - `resolutionRange` number, double: The resolution in the range direction measured in meters. - `resolutionAzimuth` number, double: The resolution in the azimuth direction measured in meters. - `groundResolutionProjection` number, double: Distance between independent measurements, representing the physical dimension that represents a pixel of the image. - `obDirection` string: The antenna pointing direction (LEFT, RIGHT). - `coordSys` string: The coordinate system used for the sensor velocity and target position vectors for the collection. - `targetposx` number, double: The collection target X position in kilometers. - `targetposy` number, double: The collection target Y position in kilometers. - `targetposz` number, double: The collection target Z position in kilometers. - `senalt` number, double: Sensor altitude during collection in kilometers. - `senvelx` number, double: Sensor platform X-velocity during collection in kilometers/second. - `senvely` number, double: Sensor platform Y-velocity during collection in kilometers/second. - `senvelz` number, double: Sensor platform Z-velocity during collection in kilometers/second. - `senlatStart` number, double: WGS-84 sensor latitude sub-point at collect start time (collectionStart), represented as -90 to 90 degrees (negative values south of equator). - `senlonStart` number, double: WGS-84 sensor longitude sub-point at collect start time (collectionStart), represented as -180 to 180 degrees (negative values west of Prime Meridian). - `senlatEnd` number, double: WGS-84 sensor latitude sub-point at collect end time (collectionEnd), represented as -90 to 90 degrees (negative values south of equator). - `senlonEnd` number, double: WGS-84 sensor longitude sub-point at collect end time (collectionEnd), represented as -180 to 180 degrees (negative values west of Prime Meridian). - `azimuthAngle` number, double: The azimuth angle, in degrees, of the SAR satellite nadir subpoint measured clockwise from true north at the subpoint. - `transactionId` string: Optional identifier to track a commercial or marketplace transaction executed to produce this data. - `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. - `srcTyps` string[]: Array of UDL record types (e.g. ANALYTICMAGERY, ESID, GROUNDIMAGE, NOTIFICATION, POI, SV, TRACK) that are related to the SAR Observation. See the associated 'srcIds' array for the record UUIDs, positionally corresponding to the record types in this array. The 'srcTyps' and 'srcIds' arrays must match in size. - `srcIds` string[]: Array of UUIDs of the UDL data records that are related to the SAR Observation. See the associated 'srcTyps' array for the specific types of data, positionally corresponding to the UUIDs in this array. The 'srcTyps' and 'srcIds' arrays must match in size. See the corresponding srcTyps array element for the data type of the UUID and use the appropriate API operation to retrieve that object (e.g. /udl/sarobservation/{uuid}). - `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. - `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. - `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. - `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 `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 info - the request optional property `items/area` became write-only - **2025-04-16** `75f764c843a9`: 5 info - api operation id `createBulks_29` removed and replaced with `` - the endpoint scheme security `BasicAuth` was removed from the API - added the new optional request property `items/azimuthAngle` - added the new optional request property `items/groundResolutionProjection` - …1 more [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/sarobservation/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)