---
title: "GET /udl/eop/history"
method: GET
path: "/udl/eop/history"
tags: ["Earth Orientation Parameters"]
---

# GET /udl/eop/history

`GET /udl/eop/history`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/udl/eop/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/<datatype>/queryhelp`) for more details on valid/required query parameter information.

## Query parameters

- `columns` string
- `eopDate` string, date-time, required
- `firstResult` integer
- `maxResults` integer

## Response `200`

OK

- EopFull[]
  - `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.
  - `eopDate` string, date-time, required: Effective date/time for the EOP values in ISO8601 UTC format. The values could be current or predicted.
  - `polarMotionState` 'I' | 'P': Flag indicating Issued (I), or Predicted (P) for this record's polar motion values.
  - `polarMotionX` number, double: The Bulletin A X coordinate value of earth polar motion at eopDate. Polar motion of the Earth is the motion of the Earth's rotational axis relative to its crust. This is measured with respect to a reference frame in which the solid Earth is fixed (a so-called Earth-centered, Earth-fixed or ECEF reference frame). Measured in arc seconds.
  - `polarMotionXUnc` number, double: Estimated uncertainty/error in polarMotionX value in arc seconds.
  - `polarMotionY` number, double: The Bulletin A Y coordinate value of earth polar motion at eopDate. Polar motion of the Earth is the motion of the Earth's rotational axis relative to its crust. This is measured with respect to a reference frame in which the solid Earth is fixed (a so-called Earth-centered, Earth-fixed or ECEF reference frame). Measured in arc seconds.
  - `polarMotionYUnc` number, double: Estimated uncertainty/error in polarMotionY value in arc seconds.
  - `ut1UTCState` 'I' | 'P': Flag indicating Issued (I), or Predicted (P) for this record''s Bulletin A UT1-UTC values.
  - `ut1UTC` number, double: The difference between the Bulletin A UT1 and UTC time scales as of eopDate in seconds.
  - `ut1UTCUnc` number, double: The estimated uncertainty/error in the ut1UTC value in seconds.
  - `lod` number, double: Bulletin A length of day or LOD in milliseconds. Universal time (UT1) is the time of the earth clock, which performs one revolution in about 24h. It is practically proportional to the sidereal time. The excess revolution time is called length of day (LOD).
  - `lodUnc` number, double: The estimated uncertainty/error in the lod value in seconds.
  - `nutationState` 'I' | 'P': Flag indicating Issued (I), or Predicted (P) for this record's nutation values (dPSI and dEpsilon).
  - `dPSI` number, double: The Bulletin A offset in longitude dDy1980 with respect to the IAU 1976 Theory of Precession and the IAU 1980 Theory of Nutation, measured in milliseconds of arc. Note: dPSI is not used when this record represents IAU 2000 data.
  - `dPSIUnc` number, double: The estimated uncertainty/error in the dPSI value in milliseconds of arc.
  - `dEpsilon` number, double: The Bulletin A offset in obliquity dDe1980 with respect to the IAU 1976 Theory of Precession and the IAU 1980 Theory of Nutation, measured in milliseconds of arc. Note: dEpsilon is not used when this record represents IAU 2000 data.
  - `dEpsilonUnc` number, double: The estimated uncertainty/error in the dEpsilon value in milliseconds of arc.
  - `dX` number, double: The Bulletin A celestial pole offset along x-axis with respect to the IAU 2000A Theory of Precession and Nutation, measured in milliseconds of arc. Note: dX is not used when this record represents IAU 1980 data.
  - `dXUnc` number, double: The estimated uncertainty/error in the Bulletin A dX value, in milliseconds of arc.
  - `dY` number, double: The Bulletin A celestial pole offset along y-axis with respect to the IAU 2000A Theory of Precession and Nutation, measured in milliseconds of arc. Note: dY is not used when this record represents IAU 1980 data.
  - `dYUnc` number, double: The estimated uncertainty/error in the Bulletin A dY value, in milliseconds of arc.
  - `polarMotionXB` number, double: Bulletin B X coordinate value of earth polar motion at eopDate. Polar motion of the Earth is the motion of the Earth's rotational axis relative to its crust. This is measured with respect to a reference frame in which the solid Earth is fixed (a so-called Earth-centered, Earth-fixed or ECEF reference frame). Measured in arc seconds.
  - `polarMotionYB` number, double: Bulletin B Y coordinate value of earth polar motion at eopDate. Polar motion of the Earth is the motion of the Earth's rotational axis relative to its crust. This is measured with respect to a reference frame in which the solid Earth is fixed (a so-called Earth-centered, Earth-fixed or ECEF reference frame). Measured in arc seconds.
  - `ut1UTCB` number, double: The Bulletin B difference between the UT1 and UTC time scales as of eopDate in seconds.
  - `dPSIB` number, double: The Bulletin B offset in longitude dDy1980 with respect to the IAU 1976 Theory of Precession and the IAU 1980 Theory of Nutation, measured in milliseconds of arc. Note: dPSIB is not used when this record represents IAU 2000 data.
  - `dEpsilonB` number, double: The Bulletin B offset in obliquity dDe1980 with respect to the IAU 1976 Theory of Precession and the IAU 1980 Theory of Nutation, measured in milliseconds of arc. Note: dEpsilonB is not used when this record represents IAU 2000 data.
  - `dXB` number, double: The Bulletin B celestial pole offset along the X-axis with respect to the IAU 2000A Theory of Precession and Nutation, measured in milliseconds of arc. Note: dXB is not used when this record represents IAU 1980 data.
  - `dYB` number, double: The Bulletin B celestial pole offset along the Y-axis with respect to the IAU 2000A Theory of Precession and Nutation, measured in milliseconds of arc. Note: dYB is not used when this record represents IAU 1980 data.
  - `precessionNutationStd` string: The IAU Theory of Precession and Theory of Nutation applied to the data in this record. IAU1980 records employ the IAU 1976 Theory of Precession and IAU 1980 Theory of Nutation, and IAU2000 records employ the IAU 2000A Theory of Precession and Nutation.
  - `rawFileURI` string: Optional URI location in the document repository of the raw file parsed by the system to produce this record. To download the raw file, prepend https://udl-hostname/scs/download?id= to this value.
  - `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.
  - `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.
  - `updatedAt` string, date-time: Time the row was last updated in the database, auto-populated by the system.
  - `updatedBy` string: Application user who updated the row in the database, auto-populated by the system.
  - `origNetwork` string: The originating source network on which this record was created, 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.

- **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 `findAllHistory_15` 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/eop/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)
