--- title: "GET /udl/laserdeconflictrequest/history" method: GET path: "/udl/laserdeconflictrequest/history" tags: ["Laser"] --- # GET /udl/laserdeconflictrequest/history `GET /udl/laserdeconflictrequest/history` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/laserdeconflictrequest/history` - Auth: none declared Service operation to dynamically query historical data by a variety of query parameters not specified in this API documentation. See the queryhelp operation (`/udl//queryhelp`) for more details on valid/required query parameter information. ## Query parameters - `columns` string - `startDate` string, date-time, required - `firstResult` integer - `maxResults` integer ## Response `200` OK - LaserDeconflictRequestFull[] - `id` string: Unique identifier of the record, auto-generated by the system if not provided on create operations. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `requestId` string, required: External identifier for this LaserDeconflictRequest record. - `laserSystemName` string: The name of the laser/beam director system. The Laser Clearinghouse will append identifiers to the name using standard conventions. - `requestTs` string, date-time, required: The datetime that this LaserDeconflictRequest record was created, in ISO 8601 UTC format with millisecond precision. - `missionName` string: The name of the mission with which this LaserDeconflictRequest is associated. - `programId` string: External identifier for the program that is responsible for this LaserDeconflictRequest. - `status` string: Status of this request (APPROVED, COMPLETE_WITH_ERRORS, COMPLETE_WITH_WARNINGS, FAILURE, IN_PROGRESS, REQUESTED, SUCCESS). - `defaultCHA` number, double: The half-angle of the safety cone of the laser beam, in degrees. - `propagator` string: The type of propagator utilized in the deconfliction/predictive avoidance calculation. - `treatEarthAs` string: Indicates the treatment of earth (INVISIBLE, VICTIM, SHIELD) for this LaserDeconflictRequest record. - `geopotentialModel` string: Indicates the geopotential model used in the propagation calculation for this request (e.g. EGM-96, WGS-84, WGS-72, WGS66, WGS60, JGM-2, or GEM-T3). - `enableDSS` boolean: Boolean enabling Dynamic Satellite Susceptibility (DSS) algorithms. - `useFieldOfRegard` boolean: Boolean indicating that, for deconfliction events in which the potential target is an optical imaging satellite, line of sight computation between target and source is ensured when the source emitter is contained within the field of regard (field of view) of the satellite's optical telescope. - `victimEnabled` boolean: Boolean indicating whether victim error growth is enabled as input to the deconfliction calculations for this request. - `sourceEnabled` boolean: Boolean indicating whether error growth of the laser beam is enabled for this request. - `targetEnabled` boolean: Boolean indicating whether target error growth is enabled for this request. - `startDate` string, date-time, required: Start date of the time windows associated with this LaserDeconflictRequest, in ISO 8601 UTC format with millisecond precision. - `endDate` string, date-time, required: End date of the time windows associated with this LaserDeconflictRequest, in ISO 8601 UTC format with millisecond precision. - `platformLocationType` string: Indicates the type of location(s) the laser platform will be operational for this request (BOX_2_WAYPOINTS, BOX_4_SURFACE_POINTS, BOX_CENTER_POINT_LINE, EXTERNAL_EPHEMERIS, FIXED_POINT, SATELLITE). - `platformLocationName` string: The name of the laser platform. - `numTargets` integer, required: The number of targets included in this request. - `targetType` string: The target type that concerns this request (BOX_2_WAYPOINTS, BOX_4_SURFACE_POINTS, BOX_CENTER_POINT_LINE, EXTERNAL_EPHEMERIS, FIXED_POINT, SATELLITE). - `laserDeconflictTargets` LaserDeconflictTargetFull[]: A list containing all laser illumination target object specifications for which deconflictions must be calculated, as planned for this request. - `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. - `idLaserDeconflictRequest` string: Unique identifier of the parent LaserDeconflictRequest record containing this target. - `startDate` string, date-time: Start date of the time windows associated with this LaserDeconflictRequest, in ISO 8601 UTC format with millisecond precision. - `targetNumber` integer: The number assigned to this target instance for a request. - `ra` number, double: The expected or directed right ascension angle of this target, in degrees. - `declination` number, double: The expected or directed declination angle of this target, in degrees. - `azimuth` number, double: The expected or directed azimuth angle of this target, in degrees. - `azimuthStart` number, double: The initial azimuth angle specifying the start of the azimuthal range that defines this target area, in degrees. - `azimuthEnd` number, double: The secondary azimuth angle specifying the end of the azimuthal range that defines this target area, in degrees. - `azimuthIncrement` number, double: The incremental change in angle over the given azimuthal range at which the target area will be engaged, in degrees. - `elevation` number, double: The expected or directed elevation angle of this target, in degrees. - `elevationStart` number, double: The initial elevation angle specifying the start of the elevation range that defines this target area, in degrees. - `elevationEnd` number, double: The secondary elevation angle specifying the end of the elevation range that defines this target area, in degrees. - `elevationIncrement` number, double: The incremental change in angle across the given elevation range at which the target area will be engaged, in degrees. - `solarSystemBody` string: The name of the target celestial body in Earth's solar system (JUPITER, MARS, MERCURY, MOON, NEPTUNE, PLUTO, SATURN, SUN, URANUS, VENUS). - `starNumber` integer: The reference number of the target star. - `targetObjectNo` integer: If this is an on-orbit target, this is the satellite/catalog number. - `targetObjectId` string: Optional target identifier provided by the source provider. This may be an internal identifier and not necessarily map to UDL entities. - `fixedPoints` FixedPointFull[]: A collection of latitude, longitude, and altitude fields which can be used to specify the geometry of the coordinate space of this target. For example, a BOX_2_WAYPOINTS would include two data points, while a BOX_4_SURFACE_POINTS would include four data points. - `latitude` number, double, required: WGS84 latitude of a point, in degrees. -90 to 90 degrees (negative values south of equator). - `longitude` number, double, required: WGS84 longitude of a point, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `height` number, double: Point height as measured from sea level, ranging from -300 to 1000 kilometers. - `lengthUpDown` number, double: Specifies the length of the vertical dimension of the geospatial box that confines the positions of the target, in kilometers. - `lengthLeftRight` number, double: Specifies the length of the horizontal dimension of the geospatial box that confines the positions of the target, in kilometers. - `lengthCenterline` number, double: The length of the centerline that passes through the center point of the geospatial box that confines the positions of the target, in kilometers. - `centerlineAzimuth` number, double: The azimuth angle of the centerline of the geospatial box that confines positions of the target, in degrees. - `centerlineElevation` number, double: The elevation angle of the centerline of the geospatial box that confines the positions of the target, in degrees. - `minimumHeight` number, double: The minimum target altitude specified as the height above/below the WGS84 ellipsoid, in kilometers. - `maximumHeight` number, double: The maximum target altitude specified as the height above/below the WGS84 ellipsoid, in kilometers. - `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. - `fixedPoints` FixedPointFull[]: A collection of latitude, longitude, and altitude fields which can be used to specify the geometry of the coordinate space in which the laser platform(s) will be operational for this request. For example, a BOX_2_WAYPOINTS would include two data points, while a BOX_4_SURFACE_POINTS would include four data points. - `latitude` number, double, required: WGS84 latitude of a point, in degrees. -90 to 90 degrees (negative values south of equator). - `longitude` number, double, required: WGS84 longitude of a point, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `height` number, double: Point height as measured from sea level, ranging from -300 to 1000 kilometers. - `lengthUpDown` number, double: Specifies the length of the vertical dimension of the geospatial box that confines the positions of the laser platform, in kilometers. - `lengthLeftRight` number, double: Specifies the length of the horizontal dimension of the geospatial box that confines the positions of the laser platform, in kilometers. - `lengthCenterline` number, double: The length of the centerline that passes through the center point of the geospatial box that confines the positions of the laser platform, in kilometers. - `centerlineAzimuth` number, double: The azimuth angle of the centerline of the geospatial box that confines positions of the laser platform, in degrees. - `centerlineElevation` number, double: The elevation angle of the centerline of the geospatial box that confines the positions of the laser platform, in degrees. - `minimumHeight` number, double: The minimum laser operating altitude specified as the height above/below the WGS84 ellipsoid where the laser is omitted from, in kilometers. - `maximumHeight` number, double: The maximum laser operating altitude specified as the height above/below the WGS84 ellipsoid where the laser is omitted from, in kilometers. - `satNo` integer: The satellite/catalog number of the on-orbit laser platform. - `idOnOrbit` string: Unique identifier of the on-orbit laser platform. - `origObjectId` string: Optional identifier provided by the source provider to indicate the on-orbit laser platform. This may be an internal identifier and not necessarily map to a valid satellite number. - `idLaserEmitters` string[], required: A list containing the id strings of the LaserEmitter records in UDL detailing the physical parameters of each laser/emitter operationally involved with this request. All laser/emitter components must be accurately described using the LaserEmitter schema and ingested into the UDL LaserEmitter service before creating a LaserDeconflictRequest. Users should create new LaserEmitter records for non-existent emitters and update existing records for any modifications. - `protectList` integer[]: A list of satellite/catalog numbers that should be protected from any and all incidence of laser illumination for the duration of this request. - `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. ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `405`: Method Not Allowed - `406`: MediaType Not Accepted by Request Headers - `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/laserdeconflictrequest/history/get.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)