--- title: "GET /udl/skyimagery" method: GET path: "/udl/skyimagery" tags: ["Sky Imagery"] --- # GET /udl/skyimagery `GET /udl/skyimagery` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/skyimagery` - Auth: none declared Service operation to dynamically query 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 - `expStartTime` string, date-time, required - `firstResult` integer - `maxResults` integer ## Response `200` OK - SkyImageryAbridged[] - `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: Optional identifier of the target on-orbit object, if correlated. - `origObjectId` string: Optional identifier provided by the imaging source to indicate the target onorbit object of this image. This may be an internal identifier and not necessarily a valid satellite number. - `idSOISet` string: Optional unique identifier of the SOI Observation Set associated with this image. - `idAttitudeSet` string: Optional identifier of the AttitudeSet data record describing the orientation of an object body. - `idSensor` string: Unique identifier of the reporting sensor. - `satNo` integer: Catalog number of the target on-orbit object. - `origSensorId` string: Optional identifier provided by the imaging source to indicate the sensor identifier which produced this image. This may be an internal identifier and not necessarily a valid sensor ID. - `senlat` number, double: Sensor latitude at exposure start epoch, in degrees. If null, can be obtained from sensor info. -90 to 90 degrees (negative values south of equator). - `senlon` number, double: Sensor longitude at exposure start epoch, in degrees. If null, can be obtained from sensor info. -180 to 180 degrees (negative values west of Prime Meridian). - `senalt` number, double: Sensor altitude at exposure start epoch, in km. If null, can be obtained from sensor info. - `senx` number, double: Sensor x position at exposure start epoch, in km (if mobile/onorbit) in J2000 coordinate frame. - `seny` number, double: Sensor y position at exposure start epoch, in km (if mobile/onorbit) in J2000 coordinate frame. - `senz` number, double: Sensor z position at exposure start epoch, in km (if mobile/onorbit) in J2000 coordinate frame. - `senQuat` number[]: The quaternion describing the rotation of the body-fixed frame used for this system into the local geodetic frame, at exposure start epoch (expStartTime). The array element order convention is scalar component first, followed by the three vector components. For a vector u in the body-fixed frame, the corresponding vector u' in the geodetic frame should satisfy u' = quq*, where q is this quaternion. - `senQuatDot` number[]: The derivative of the quaternion describing the rotation of the body-fixed frame used for this system into the local geodetic frame, exposure start epoch (expStartTime). The array element order convention is scalar component first, followed by the three vector components. For a vector u in the body-fixed frame, the corresponding vector u' in the geodetic frame should satisfy u' = quq*, where q is this quaternion. - `imageType` string, required: The type of image associated with this record (e.g. FITS, EOSSA, EOCHIP, MP4). - `expStartTime` string, date-time, required: Start time of the exposure, in ISO 8601 UTC format with microsecond precision. - `expEndTime` string, date-time: End time of the exposure, in ISO 8601 UTC format with microsecond precision. - `imageSourceInfo` string: String that uniquely identifies the data source. - `topLeftStartAz` number, double: The telescope pointing azimuth, in degrees, at the exposure start epoch. - `topLeftStartEl` number, double: The telescope pointing elevation, in degrees, at the exposure start epoch. - `topLeftStopAz` number, double: The telescope pointing azimuth, in degrees, at the exposure stop epoch. - `topLeftStopEl` number, double: The telescope pointing elevation, in degrees, at the exposure stop epoch. - `imageSetId` string: The user-defined set ID of a sequence of images. - `imageSetLength` integer: The number of images in an image set. - `sequenceId` integer: The sequence ID of an image within an image set. - `frameFOVWidth` number, double: Field Of View frame width, in degrees. - `frameFOVHeight` number, double: Field Of View frame height, in degrees. - `pixelFOVWidth` number, double: Field Of View pixel width, in degrees. - `pixelFOVHeight` number, double: Field Of View pixel height, in degrees. - `frameWidthPixels` integer: Frame width of the image, in number of pixels. - `frameHeightPixels` integer: Frame height of the image, in number of pixels. - `pixelBitDepth` integer: Bit depth of the image, in number of pixels. - `annotationKey` string: Reference to an annotation document associated with this image. - `calibrationKey` string: Reference to a calibration document associated with this image. - `filename` string: Name of the uploaded image file. - `filesize` integer: Size of the image file, in bytes. - `checksumValue` string: MD5 value of the file. The ingest/create operation will automatically generate the value. - `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. - `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. - `description` string: Optional name/description associated with this image. - `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. - `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. ## 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. - **2026-03-25** `173e4aff893f`: 2 breaking - the `items/senQuat` response property's minItems was decreased from `4` to `0` for the response status `200` - the `items/senQuatDot` response property's minItems was decreased from `4` to `0` for the response status `200` - **2025-05-29** `4e1cbc17e814`: 2 info - added the new optional `query` request parameter `firstResult` - added the new optional `query` request parameter `maxResults` - **2025-04-16** `75f764c843a9`: 2 info - api operation id `findAll_117` removed and replaced with `` - the endpoint scheme security `BasicAuth` was removed from the API [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/skyimagery/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)