udl-sdk 0.1.0a6__py3-none-any.whl → 0.1.0a8__py3-none-any.whl

unifieddatalibrary/types/sensor_plan/history_retrieve_response.py

@@ -0,0 +1,1626 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal, TypeAlias
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+from ..shared.collect_response_full import CollectResponseFull
+
+__all__ = [
+    "HistoryRetrieveResponse",
+    "HistoryRetrieveResponseItem",
+    "HistoryRetrieveResponseItemCollectRequest",
+    "HistoryRetrieveResponseItemCollectRequestElset",
+    "HistoryRetrieveResponseItemCollectRequestStateVector",
+]
+
+
+class HistoryRetrieveResponseItemCollectRequestElset(BaseModel):
+    classification_marking: str = FieldInfo(alias="classificationMarking")
+    """Classification marking of the data in IC/CAPCO Portion-marked format."""
+
+    data_mode: Literal["REAL", "TEST", "SIMULATED", "EXERCISE"] = FieldInfo(alias="dataMode")
+    """Indicator of whether the data is EXERCISE, REAL, SIMULATED, or TEST data:
+
+    EXERCISE: Data pertaining to a government or military exercise. The data
+    may include both real and simulated data.
+
+    REAL: Data collected or produced that pertains to real-world objects,
+    events, and analysis.
+
+    SIMULATED: Synthetic data generated by a model to mimic real-world
+    datasets.
+
+    TEST: Specific datasets used to evaluate compliance with specifications and
+    requirements, and for validating technical, functional, and performance
+    characteristics.
+    """
+
+    epoch: datetime
+    """Elset epoch time in ISO 8601 UTC format, with microsecond precision."""
+
+    source: str
+    """Source of the data."""
+
+    agom: Optional[float] = None
+    """
+    AGOM, expressed in m^2/kg, is the value of the (averaged) object Area times the
+    solar radiation pressure coefficient(Gamma) over the object Mass. Applicable
+    only with ephemType4.
+    """
+
+    algorithm: Optional[str] = None
+    """Optional algorithm used to produce this record."""
+
+    apogee: Optional[float] = None
+    """The orbit point furthest from the center of the earth in kilometers.
+
+    If not provided, apogee will be computed from the TLE according to the
+    following. Using mu, the standard gravitational parameter for the earth
+    (398600.4418), semi-major axis A = (mu/(n _ 2 _ pi/(24*3600))^2)(1/3). Using
+    semi-major axis A, eccentricity E, apogee = (A * (1 + E)) in km. Note that the
+    calculations are for computing the apogee radius from the center of the earth,
+    to compute apogee altitude the radius of the earth should be subtracted
+    (6378.135 km).
+    """
+
+    arg_of_perigee: Optional[float] = FieldInfo(alias="argOfPerigee", default=None)
+    """
+    The argument of perigee is the angle in degrees formed between the perigee and
+    the ascending node. If the perigee would occur at the ascending node, the
+    argument of perigee would be 0.
+    """
+
+    ballistic_coeff: Optional[float] = FieldInfo(alias="ballisticCoeff", default=None)
+    """Ballistic coefficient, in m^2/kg. Applicable only with ephemType4."""
+
+    b_star: Optional[float] = FieldInfo(alias="bStar", default=None)
+    """
+    The drag term for SGP4 orbital model, used for calculating decay constants for
+    altitude, eccentricity etc, measured in inverse earth radii.
+    """
+
+    created_at: Optional[datetime] = FieldInfo(alias="createdAt", default=None)
+    """Time the row was created in the database, auto-populated by the system."""
+
+    created_by: Optional[str] = FieldInfo(alias="createdBy", default=None)
+    """
+    Application user who created the row in the database, auto-populated by the
+    system.
+    """
+
+    descriptor: Optional[str] = None
+    """Optional source-provided and searchable metadata or descriptor of the data."""
+
+    eccentricity: Optional[float] = None
+    """
+    The orbital eccentricity of an astronomical object is a parameter that
+    determines the amount by which its orbit around another body deviates from a
+    perfect circle. A value of 0 is a circular orbit, values between 0 and 1 form an
+    elliptic orbit, 1 is a parabolic escape orbit, and greater than 1 is a
+    hyperbolic escape orbit.
+    """
+
+    effective_from: Optional[datetime] = FieldInfo(alias="effectiveFrom", default=None)
+    """
+    Read-only start time at which this elset was the 'current' elset for its
+    satellite. This field and is set by the system automatically and ignored on
+    create/edit operations.
+    """
+
+    effective_until: Optional[datetime] = FieldInfo(alias="effectiveUntil", default=None)
+    """
+    Read-only end time at which this elset was no longer the 'current' elset for its
+    satellite. This field and is set by the system automatically and ignored on
+    create/edit operations.
+    """
+
+    ephem_type: Optional[int] = FieldInfo(alias="ephemType", default=None)
+    """The ephemeris type associated with this TLE:
+
+    0: SGP (or SGP4 with Kozai mean motion)
+
+    1: SGP (Kozai mean motion)
+
+    2: SGP4 (Brouver mean motion)
+
+    3: SDP4
+
+    4: SGP4-XP
+
+    5: SDP8
+
+    6: SP (osculating mean motion)
+    """
+
+    id_elset: Optional[str] = FieldInfo(alias="idElset", default=None)
+    """Unique identifier of the record, auto-generated by the system."""
+
+    id_on_orbit: Optional[str] = FieldInfo(alias="idOnOrbit", default=None)
+    """Unique identifier of the satellite on-orbit object, if correlated.
+
+    For the public catalog, the idOnOrbit is typically the satellite number as a
+    string, but may be a UUID for analyst or other unknown or untracked satellites.
+    """
+
+    id_orbit_determination: Optional[str] = FieldInfo(alias="idOrbitDetermination", default=None)
+    """Unique identifier of the OD solution record that produced this elset.
+
+    This ID can be used to obtain additional information on an OrbitDetermination
+    object using the 'get by ID' operation (e.g. /udl/orbitdetermination/{id}). For
+    example, the OrbitDetermination with idOrbitDetermination = abc would be queried
+    as /udl/orbitdetermination/abc.
+    """
+
+    inclination: Optional[float] = None
+    """
+    The angle between the equator and the orbit when looking from the center of the
+    Earth. If the orbit went exactly around the equator from left to right, then the
+    inclination would be 0. The inclination ranges from 0 to 180 degrees.
+    """
+
+    line1: Optional[str] = None
+    """
+    Read only derived/generated line1 of a legacy TLE (two line element set) format,
+    ignored on create/edit operations.
+    """
+
+    line2: Optional[str] = None
+    """
+    Read only derived/generated line2 of a legacy TLE (two line element set) format,
+    ignored on create/edit operations.
+    """
+
+    mean_anomaly: Optional[float] = FieldInfo(alias="meanAnomaly", default=None)
+    """Where the satellite is in its orbital path.
+
+    The mean anomaly ranges from 0 to 360 degrees. The mean anomaly is referenced to
+    the perigee. If the satellite were at the perigee, the mean anomaly would be 0.
+    """
+
+    mean_motion: Optional[float] = FieldInfo(alias="meanMotion", default=None)
+    """
+    Mean motion is the angular speed required for a body to complete one orbit,
+    assuming constant speed in a circular orbit which completes in the same time as
+    the variable speed, elliptical orbit of the actual body. Measured in revolutions
+    per day.
+    """
+
+    mean_motion_d_dot: Optional[float] = FieldInfo(alias="meanMotionDDot", default=None)
+    """2nd derivative of the mean motion with respect to time.
+
+    Units are revolutions per day cubed.
+    """
+
+    mean_motion_dot: Optional[float] = FieldInfo(alias="meanMotionDot", default=None)
+    """1st derivative of the mean motion with respect to time.
+
+    Units are revolutions per day squared.
+    """
+
+    origin: Optional[str] = None
+    """
+    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.
+    """
+
+    orig_network: Optional[str] = FieldInfo(alias="origNetwork", default=None)
+    """
+    The originating source network on which this record was created, auto-populated
+    by the system.
+    """
+
+    orig_object_id: Optional[str] = FieldInfo(alias="origObjectId", default=None)
+    """
+    Optional identifier provided by elset source to indicate the target onorbit
+    object of this elset. This may be an internal identifier and not necessarily map
+    to a valid satellite number.
+    """
+
+    perigee: Optional[float] = None
+    """The orbit point nearest to the center of the earth in kilometers.
+
+    If not provided, perigee will be computed from the TLE according to the
+    following. Using mu, the standard gravitational parameter for the earth
+    (398600.4418), semi-major axis A = (mu/(n _ 2 _ pi/(24*3600))^2)(1/3). Using
+    semi-major axis A, eccentricity E, perigee = (A * (1 - E)) in km. Note that the
+    calculations are for computing the perigee radius from the center of the earth,
+    to compute perigee altitude the radius of the earth should be subtracted
+    (6378.135 km).
+    """
+
+    period: Optional[float] = None
+    """Period of the orbit equal to inverse of mean motion, in minutes."""
+
+    raan: Optional[float] = None
+    """
+    Right ascension of the ascending node, or RAAN is the angle as measured in
+    degrees eastwards (or, as seen from the north, counterclockwise) from the First
+    Point of Aries to the ascending node, which is where the orbit crosses the
+    equator when traveling north.
+    """
+
+    raw_file_uri: Optional[str] = FieldInfo(alias="rawFileURI", default=None)
+    """
+    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.
+    """
+
+    rev_no: Optional[int] = FieldInfo(alias="revNo", default=None)
+    """The current revolution number.
+
+    The value is incremented when a satellite crosses the equator on an ascending
+    pass.
+    """
+
+    sat_no: Optional[int] = FieldInfo(alias="satNo", default=None)
+    """Satellite/catalog number of the target on-orbit object."""
+
+    semi_major_axis: Optional[float] = FieldInfo(alias="semiMajorAxis", default=None)
+    """The sum of the periapsis and apoapsis distances divided by two.
+
+    For circular orbits, the semimajor axis is the distance between the centers of
+    the bodies, not the distance of the bodies from the center of mass. Units are
+    kilometers.
+    """
+
+    sourced_data: Optional[List[str]] = FieldInfo(alias="sourcedData", default=None)
+    """Optional array of UDL data (observation) UUIDs used to build this element set.
+
+    See the associated sourcedDataTypes array for the specific types of observations
+    for the positionally corresponding UUIDs in this array (the two arrays must
+    match in size).
+    """
+
+    sourced_data_types: Optional[List[Literal["EO", "RADAR", "RF", "DOA", "ELSET", "SV"]]] = FieldInfo(
+        alias="sourcedDataTypes", default=None
+    )
+    """Optional array of UDL observation data types used to build this element set
+    (e.g.
+
+    EO, RADAR, RF, DOA). See the associated sourcedData array for the specific UUIDs
+    of observations for the positionally corresponding data types in this array (the
+    two arrays must match in size).
+    """
+
+    source_dl: Optional[str] = FieldInfo(alias="sourceDL", default=None)
+    """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.
+    """
+
+    tags: Optional[List[str]] = None
+    """
+    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.
+    """
+
+    transaction_id: Optional[str] = FieldInfo(alias="transactionId", default=None)
+    """
+    Optional identifier to track a commercial or marketplace transaction executed to
+    produce this data.
+    """
+
+    uct: Optional[bool] = None
+    """Boolean indicating this Elset was unable to be correlated to a known object.
+
+    This flag should only be set to true by data providers after an attempt to
+    correlate to an on-orbit object was made and failed. If unable to correlate, the
+    'origObjectId' field may be populated with an internal data provider specific
+    identifier.
+    """
+
+
+class HistoryRetrieveResponseItemCollectRequestStateVector(BaseModel):
+    classification_marking: str = FieldInfo(alias="classificationMarking")
+    """Classification marking of the data in IC/CAPCO Portion-marked format."""
+
+    data_mode: Literal["REAL", "TEST", "SIMULATED", "EXERCISE"] = FieldInfo(alias="dataMode")
+    """Indicator of whether the data is EXERCISE, REAL, SIMULATED, or TEST data:
+
+    EXERCISE: Data pertaining to a government or military exercise. The data
+    may include both real and simulated data.
+
+    REAL: Data collected or produced that pertains to real-world objects,
+    events, and analysis.
+
+    SIMULATED: Synthetic data generated by a model to mimic real-world
+    datasets.
+
+    TEST: Specific datasets used to evaluate compliance with specifications and
+    requirements, and for validating technical, functional, and performance
+    characteristics.
+    """
+
+    epoch: datetime
+    """
+    Time of validity for state vector in ISO 8601 UTC datetime format, with
+    microsecond precision.
+    """
+
+    source: str
+    """Source of the data."""
+
+    actual_od_span: Optional[float] = FieldInfo(alias="actualODSpan", default=None)
+    """The actual time span used for the OD of the object, expressed in days."""
+
+    algorithm: Optional[str] = None
+    """Optional algorithm used to produce this record."""
+
+    alt1_reference_frame: Optional[str] = FieldInfo(alias="alt1ReferenceFrame", default=None)
+    """The reference frame of the alternate1 (Alt1) cartesian orbital state."""
+
+    alt2_reference_frame: Optional[str] = FieldInfo(alias="alt2ReferenceFrame", default=None)
+    """The reference frame of the alternate2 (Alt2) cartesian orbital state."""
+
+    area: Optional[float] = None
+    """
+    The actual area of the object at it's largest cross-section, expressed in
+    meters^2.
+    """
+
+    b_dot: Optional[float] = FieldInfo(alias="bDot", default=None)
+    """First derivative of drag/ballistic coefficient (m2/kg-s)."""
+
+    cm_offset: Optional[float] = FieldInfo(alias="cmOffset", default=None)
+    """Model parameter value for center of mass offset (m)."""
+
+    cov: Optional[List[float]] = None
+    """
+    Covariance matrix, in kilometer and second based units, in the specified
+    covReferenceFrame. If the covReferenceFrame is null it is assumed to be J2000.
+    The array values (1-21) represent the lower triangular half of the
+    position-velocity covariance matrix. The size of the covariance matrix is
+    dynamic, depending on whether the covariance for position only or position &
+    velocity. The covariance elements are position dependent within the array with
+    values ordered as follows:
+
+               x    y    z    x'    y'    z'    DRG    SRP    THR  
+
+    x         1
+
+    y         2    3
+
+    z         4    5    6
+
+    x'        7    8    9   10
+
+    y'       11  12  13  14  15
+
+    z'       16  17  18  19  20   21 
+
+    The cov array should contain only the lower left triangle values from top left
+    down to bottom right, in order.
+
+    If additional covariance terms are included for DRAG, SRP, and/or THRUST, the
+    matrix can be extended with the following order of elements:
+
+               x    y    z    x'    y'    z'    DRG    SRP    THR
+
+    DRG   22  23  24  25  26   27      28  
+
+    SRP   29  30  31  32  33   34      35       36  
+
+    THR   37  38  39  40  41   42      43       44       45 
+    """
+
+    cov_method: Optional[str] = FieldInfo(alias="covMethod", default=None)
+    """
+    The method used to generate the covariance during the orbit determination (OD)
+    that produced the state vector, or whether an arbitrary, non-calculated default
+    value was used (CALCULATED, DEFAULT).
+    """
+
+    cov_reference_frame: Optional[Literal["J2000", "UVW"]] = FieldInfo(alias="covReferenceFrame", default=None)
+    """The reference frame of the covariance matrix elements.
+
+    If the covReferenceFrame is null it is assumed to be J2000.
+    """
+
+    created_at: Optional[datetime] = FieldInfo(alias="createdAt", default=None)
+    """Time the row was created in the database, auto-populated by the system."""
+
+    created_by: Optional[str] = FieldInfo(alias="createdBy", default=None)
+    """
+    Application user who created the row in the database, auto-populated by the
+    system.
+    """
+
+    descriptor: Optional[str] = None
+    """Optional source-provided and searchable metadata or descriptor of the data."""
+
+    drag_area: Optional[float] = FieldInfo(alias="dragArea", default=None)
+    """
+    The effective area of the object exposed to atmospheric drag, expressed in
+    meters^2.
+    """
+
+    drag_coeff: Optional[float] = FieldInfo(alias="dragCoeff", default=None)
+    """Area-to-mass ratio coefficient for atmospheric ballistic drag (m2/kg)."""
+
+    drag_model: Optional[str] = FieldInfo(alias="dragModel", default=None)
+    """The Drag Model used for this vector (e.g.
+
+    HARRIS-PRIESTER, JAC70, JBH09, MSIS90, NONE, etc.).
+    """
+
+    edr: Optional[float] = None
+    """Model parameter value for energy dissipation rate (EDR) (w/kg)."""
+
+    effective_from: Optional[datetime] = FieldInfo(alias="effectiveFrom", default=None)
+    """
+    Start time at which this state vector was the 'current' state vector for its
+    satellite.
+    """
+
+    effective_until: Optional[datetime] = FieldInfo(alias="effectiveUntil", default=None)
+    """
+    End time at which this state vector was no longer the 'current' state vector for
+    its satellite.
+    """
+
+    eq_cov: Optional[List[float]] = FieldInfo(alias="eqCov", default=None)
+    """
+    The covariance matrix values represent the lower triangular half of the
+    covariance matrix in terms of equinoctial elements.  The size of the
+    covariance matrix is dynamic.  The values are outputted in order across
+    each row, i.e.:
+
+    1   2   3   4   5
+
+    6   7   8   9  10
+
+    :   :   :   :   :
+
+    :   :   :   :   :
+
+    51  52  53  54  55
+
+    :   :   :   :   :
+
+    :   :   :   :   :
+
+    The ordering of values is as follows:
+
+               Af  
+    Ag   L    N   Chi  Psi  
+    B   BDOT AGOM  T   C1   C2  ...
+
+    Af        1
+
+    Ag        2    3
+
+    L          
+    4    5    6
+
+    N          
+    7    8    9   10
+
+    Chi       11   12  
+    13   14   15
+
+    Psi       16   17  
+    18   19   20   21
+
+    B          22  
+    23   24   25   26   27   28
+
+    BDOT   29   30   31   32  
+    33   34   35   36
+
+    AGOM  37   38   39   40  
+    41   42   43   44   45
+
+    T           46  
+    47   48   49   50   51  
+    52   53   54   55
+
+    C1         56   57  
+    58   59   60   61   62  
+    63   64   65   66
+
+    C2         67   68  
+    69   70   71   72   73  
+    74   75   76   77   78
+
+    :
+
+    :
+
+    where C1, C2, etc, are the "consider parameters" that may be added to the
+    covariance matrix.  The covariance matrix will be as large as the last
+    element/model parameter needed.  In other words, if the DC solved for all 6
+    elements plus AGOM, the covariance matrix will be 9x9 (and the rows for B and
+    BDOT will be all zeros).  If the covariance matrix is unavailable, the size
+    will be set to 0x0, and no data will follow.  The cov field should contain
+    only the lower left triangle values from top left down to bottom right, in
+    order.
+    """
+
+    error_control: Optional[float] = FieldInfo(alias="errorControl", default=None)
+    """Integrator error control."""
+
+    fixed_step: Optional[bool] = FieldInfo(alias="fixedStep", default=None)
+    """Boolean indicating use of fixed step size for this vector."""
+
+    geopotential_model: Optional[str] = FieldInfo(alias="geopotentialModel", default=None)
+    """Geopotential model used for this vector (e.g.
+
+    EGM-96, WGS-84, WGS-72, JGM-2, or GEM-T3), including mm degree zonals, nn
+    degree/order tesserals. E.g. EGM-96 24Z,24T.
+    """
+
+    iau1980_terms: Optional[int] = FieldInfo(alias="iau1980Terms", default=None)
+    """Number of terms used in the IAU 1980 nutation model (4, 50, or 106)."""
+
+    id_on_orbit: Optional[str] = FieldInfo(alias="idOnOrbit", default=None)
+    """Unique identifier of the satellite on-orbit object, if correlated.
+
+    For the public catalog, the idOnOrbit is typically the satellite number as a
+    string, but may be a UUID for analyst or other unknown or untracked satellites.
+    """
+
+    id_orbit_determination: Optional[str] = FieldInfo(alias="idOrbitDetermination", default=None)
+    """Unique identifier of the OD solution record that produced this state vector.
+
+    This ID can be used to obtain additional information on an OrbitDetermination
+    object using the 'get by ID' operation (e.g. /udl/orbitdetermination/{id}). For
+    example, the OrbitDetermination with idOrbitDetermination = abc would be queries
+    as /udl/orbitdetermination/abc.
+    """
+
+    id_state_vector: Optional[str] = FieldInfo(alias="idStateVector", default=None)
+    """Unique identifier of the record, auto-generated by the system."""
+
+    integrator_mode: Optional[str] = FieldInfo(alias="integratorMode", default=None)
+    """Integrator Mode."""
+
+    in_track_thrust: Optional[bool] = FieldInfo(alias="inTrackThrust", default=None)
+    """Boolean indicating use of in-track thrust perturbations for this vector."""
+
+    last_ob_end: Optional[datetime] = FieldInfo(alias="lastObEnd", default=None)
+    """
+    The end of the time interval containing the time of the last accepted
+    observation, in ISO 8601 UTC format with microsecond precision. For an exact
+    observation time, the firstObTime and lastObTime are the same.
+    """
+
+    last_ob_start: Optional[datetime] = FieldInfo(alias="lastObStart", default=None)
+    """
+    The start of the time interval containing the time of the last accepted
+    observation, in ISO 8601 UTC format with microsecond precision. For an exact
+    observation time, the firstObTime and lastObTime are the same.
+    """
+
+    leap_second_time: Optional[datetime] = FieldInfo(alias="leapSecondTime", default=None)
+    """Time of the next leap second after epoch in ISO 8601 UTC time.
+
+    If the next leap second is not known, the time of the previous leap second is
+    used.
+    """
+
+    lunar_solar: Optional[bool] = FieldInfo(alias="lunarSolar", default=None)
+    """Boolean indicating use of lunar/solar perturbations for this vector."""
+
+    mass: Optional[float] = None
+    """The mass of the object, in kilograms."""
+
+    obs_available: Optional[int] = FieldInfo(alias="obsAvailable", default=None)
+    """The number of observations available for the OD of the object."""
+
+    obs_used: Optional[int] = FieldInfo(alias="obsUsed", default=None)
+    """The number of observations accepted for the OD of the object."""
+
+    origin: Optional[str] = None
+    """
+    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.
+    """
+
+    orig_network: Optional[str] = FieldInfo(alias="origNetwork", default=None)
+    """
+    The originating source network on which this record was created, auto-populated
+    by the system.
+    """
+
+    orig_object_id: Optional[str] = FieldInfo(alias="origObjectId", default=None)
+    """
+    Optional identifier provided by state vector source to indicate the target
+    onorbit object of this state vector. This may be an internal identifier and not
+    necessarily map to a valid satellite number.
+    """
+
+    partials: Optional[str] = None
+    """Type of partial derivatives used (ANALYTIC, FULL NUM, or FAST NUM)."""
+
+    pedigree: Optional[str] = None
+    """
+    The pedigree of state vector, or methods used for its generation to include
+    state update/orbit determination, propagation from another state, or a state
+    from a calibration satellite (e.g. ORBIT_UPDATE, PROPAGATION, CALIBRATION,
+    CONJUNCTION, FLIGHT_PLAN).
+    """
+
+    polar_motion_x: Optional[float] = FieldInfo(alias="polarMotionX", default=None)
+    """Polar Wander Motion X (arc seconds)."""
+
+    polar_motion_y: Optional[float] = FieldInfo(alias="polarMotionY", default=None)
+    """Polar Wander Motion Y (arc seconds)."""
+
+    pos_unc: Optional[float] = FieldInfo(alias="posUnc", default=None)
+    """One sigma position uncertainty, in kilometers."""
+
+    raw_file_uri: Optional[str] = FieldInfo(alias="rawFileURI", default=None)
+    """
+    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.
+    """
+
+    rec_od_span: Optional[float] = FieldInfo(alias="recODSpan", default=None)
+    """The recommended OD time span calculated for the object, expressed in days."""
+
+    reference_frame: Optional[Literal["J2000", "EFG/TDR", "ECR/ECEF", "TEME", "ITRF", "GCRF"]] = FieldInfo(
+        alias="referenceFrame", default=None
+    )
+    """The reference frame of the cartesian orbital states.
+
+    If the referenceFrame is null it is assumed to be J2000.
+    """
+
+    residuals_acc: Optional[float] = FieldInfo(alias="residualsAcc", default=None)
+    """The percentage of residuals accepted in the OD of the object."""
+
+    rev_no: Optional[int] = FieldInfo(alias="revNo", default=None)
+    """Epoch revolution number."""
+
+    rms: Optional[float] = None
+    """
+    The Weighted Root Mean Squared (RMS) of the differential correction on the
+    target object that produced this vector. WRMS is a quality indicator of the
+    state vector update, with a value of 1.00 being optimal. WRMS applies to Batch
+    Least Squares (BLS) processes.
+    """
+
+    sat_no: Optional[int] = FieldInfo(alias="satNo", default=None)
+    """Satellite/Catalog number of the target OnOrbit object."""
+
+    sigma_pos_uvw: Optional[List[float]] = FieldInfo(alias="sigmaPosUVW", default=None)
+    """
+    Array containing the standard deviation of error in target object position, U, V
+    and W direction respectively (km).
+    """
+
+    sigma_vel_uvw: Optional[List[float]] = FieldInfo(alias="sigmaVelUVW", default=None)
+    """
+    Array containing the standard deviation of error in target object velocity, U, V
+    and W direction respectively (km/sec).
+    """
+
+    solar_flux_ap_avg: Optional[float] = FieldInfo(alias="solarFluxAPAvg", default=None)
+    """Average solar flux geomagnetic index."""
+
+    solar_flux_f10: Optional[float] = FieldInfo(alias="solarFluxF10", default=None)
+    """F10 (10.7 cm) solar flux value."""
+
+    solar_flux_f10_avg: Optional[float] = FieldInfo(alias="solarFluxF10Avg", default=None)
+    """F10 (10.7 cm) solar flux 81-day average value."""
+
+    solar_rad_press: Optional[bool] = FieldInfo(alias="solarRadPress", default=None)
+    """
+    Boolean indicating use of solar radiation pressure perturbations for this
+    vector.
+    """
+
+    solar_rad_press_coeff: Optional[float] = FieldInfo(alias="solarRadPressCoeff", default=None)
+    """Area-to-mass ratio coefficient for solar radiation pressure."""
+
+    solid_earth_tides: Optional[bool] = FieldInfo(alias="solidEarthTides", default=None)
+    """Boolean indicating use of solid earth tide perturbations for this vector."""
+
+    sourced_data: Optional[List[str]] = FieldInfo(alias="sourcedData", default=None)
+    """Optional array of UDL data (observation) UUIDs used to build this state vector.
+
+    See the associated sourcedDataTypes array for the specific types of observations
+    for the positionally corresponding UUIDs in this array (the two arrays must
+    match in size).
+    """
+
+    sourced_data_types: Optional[List[Literal["EO", "RADAR", "RF", "DOA", "ELSET", "SV"]]] = FieldInfo(
+        alias="sourcedDataTypes", default=None
+    )
+    """
+    Optional array of UDL observation data types used to build this state vector
+    (e.g. EO, RADAR, RF, DOA). See the associated sourcedData array for the specific
+    UUIDs of observations for the positionally corresponding data types in this
+    array (the two arrays must match in size).
+    """
+
+    source_dl: Optional[str] = FieldInfo(alias="sourceDL", default=None)
+    """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.
+    """
+
+    srp_area: Optional[float] = FieldInfo(alias="srpArea", default=None)
+    """
+    The effective area of the object exposed to solar radiation pressure, expressed
+    in meters^2.
+    """
+
+    step_mode: Optional[str] = FieldInfo(alias="stepMode", default=None)
+    """Integrator step mode (AUTO, TIME, or S)."""
+
+    step_size: Optional[float] = FieldInfo(alias="stepSize", default=None)
+    """Initial integration step size (seconds)."""
+
+    step_size_selection: Optional[str] = FieldInfo(alias="stepSizeSelection", default=None)
+    """Initial step size selection (AUTO or MANUAL)."""
+
+    tags: Optional[List[str]] = None
+    """
+    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.
+    """
+
+    tai_utc: Optional[float] = FieldInfo(alias="taiUtc", default=None)
+    """
+    TAI (Temps Atomique International) minus UTC (Universal Time Coordinates) offset
+    in seconds.
+    """
+
+    thrust_accel: Optional[float] = FieldInfo(alias="thrustAccel", default=None)
+    """Model parameter value for thrust acceleration (m/s2)."""
+
+    tracks_avail: Optional[int] = FieldInfo(alias="tracksAvail", default=None)
+    """The number of sensor tracks available for the OD of the object."""
+
+    tracks_used: Optional[int] = FieldInfo(alias="tracksUsed", default=None)
+    """The number of sensor tracks accepted for the OD of the object."""
+
+    transaction_id: Optional[str] = FieldInfo(alias="transactionId", default=None)
+    """
+    Optional identifier to track a commercial or marketplace transaction executed to
+    produce this data.
+    """
+
+    uct: Optional[bool] = None
+    """
+    Boolean indicating this state vector was unable to be correlated to a known
+    object. This flag should only be set to true by data providers after an attempt
+    to correlate to an OnOrbit object was made and failed. If unable to correlate,
+    the 'origObjectId' field may be populated with an internal data provider
+    specific identifier.
+    """
+
+    ut1_rate: Optional[float] = FieldInfo(alias="ut1Rate", default=None)
+    """Rate of change of UT1 (milliseconds/day) - first derivative of ut1Utc."""
+
+    ut1_utc: Optional[float] = FieldInfo(alias="ut1Utc", default=None)
+    """Universal Time-1 (UT1) minus UTC offset, in seconds."""
+
+    vel_unc: Optional[float] = FieldInfo(alias="velUnc", default=None)
+    """One sigma velocity uncertainty, in kilometers/second."""
+
+    xaccel: Optional[float] = None
+    """
+    Cartesian X acceleration of target, in kilometers/second^2, in the specified
+    referenceFrame. If referenceFrame is null then J2K should be assumed.
+    """
+
+    xpos: Optional[float] = None
+    """
+    Cartesian X position of the target, in kilometers, in the specified
+    referenceFrame. If referenceFrame is null then J2K should be assumed.
+    """
+
+    xpos_alt1: Optional[float] = FieldInfo(alias="xposAlt1", default=None)
+    """
+    Cartesian X position of the target, in kilometers, in the specified
+    alt1ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    xpos_alt2: Optional[float] = FieldInfo(alias="xposAlt2", default=None)
+    """
+    Cartesian X position of the target, in kilometers, in the specified
+    alt2ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    xvel: Optional[float] = None
+    """
+    Cartesian X velocity of target, in kilometers/second, in the specified
+    referenceFrame. If referenceFrame is null then J2K should be assumed.
+    """
+
+    xvel_alt1: Optional[float] = FieldInfo(alias="xvelAlt1", default=None)
+    """
+    Cartesian X velocity of the target, in kilometers/second, in the specified
+    alt1ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    xvel_alt2: Optional[float] = FieldInfo(alias="xvelAlt2", default=None)
+    """
+    Cartesian X velocity of the target, in kilometers/second, in the specified
+    alt2ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    yaccel: Optional[float] = None
+    """
+    Cartesian Y acceleration of target, in kilometers/second^2, in the specified
+    referenceFrame. If referenceFrame is null then J2K should be assumed.
+    """
+
+    ypos: Optional[float] = None
+    """
+    Cartesian Y position of the target, in kilometers, in the specified
+    referenceFrame. If referenceFrame is null then J2K should be assumed.
+    """
+
+    ypos_alt1: Optional[float] = FieldInfo(alias="yposAlt1", default=None)
+    """
+    Cartesian Y position of the target, in kilometers, in the specified
+    alt1ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    ypos_alt2: Optional[float] = FieldInfo(alias="yposAlt2", default=None)
+    """
+    Cartesian Y position of the target, in kilometers, in the specified
+    alt2ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    yvel: Optional[float] = None
+    """
+    Cartesian Y velocity of target, in kilometers/second, in the specified
+    referenceFrame. If referenceFrame is null then J2K should be assumed.
+    """
+
+    yvel_alt1: Optional[float] = FieldInfo(alias="yvelAlt1", default=None)
+    """
+    Cartesian Y velocity of the target, in kilometers/second, in the specified
+    alt1ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    yvel_alt2: Optional[float] = FieldInfo(alias="yvelAlt2", default=None)
+    """
+    Cartesian Y velocity of the target, in kilometers/second, in the specified
+    alt2ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    zaccel: Optional[float] = None
+    """
+    Cartesian Z acceleration of target, in kilometers/second^2, in the specified
+    referenceFrame. If referenceFrame is null then J2K should be assumed.
+    """
+
+    zpos: Optional[float] = None
+    """
+    Cartesian Z position of the target, in kilometers, in the specified
+    referenceFrame. If referenceFrame is null then J2K should be assumed.
+    """
+
+    zpos_alt1: Optional[float] = FieldInfo(alias="zposAlt1", default=None)
+    """
+    Cartesian Z position of the target, in kilometers, in the specified
+    alt1ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    zpos_alt2: Optional[float] = FieldInfo(alias="zposAlt2", default=None)
+    """
+    Cartesian Z position of the target, in kilometers, in the specified
+    alt2ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    zvel: Optional[float] = None
+    """
+    Cartesian Z velocity of target, in kilometers/second, in the specified
+    referenceFrame. If referenceFrame is null then J2K should be assumed.
+    """
+
+    zvel_alt1: Optional[float] = FieldInfo(alias="zvelAlt1", default=None)
+    """
+    Cartesian Z velocity of the target, in kilometers/second, in the specified
+    alt1ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+    zvel_alt2: Optional[float] = FieldInfo(alias="zvelAlt2", default=None)
+    """
+    Cartesian Z velocity of the target, in kilometers/second, in the specified
+    alt2ReferenceFrame. Alternate reference frames are optional and are intended to
+    allow a data source to provide an equivalent vector in a different cartesian
+    frame than the primary vector.
+    """
+
+
+class HistoryRetrieveResponseItemCollectRequest(BaseModel):
+    classification_marking: str = FieldInfo(alias="classificationMarking")
+    """Classification marking of the data in IC/CAPCO Portion-marked format."""
+
+    data_mode: Literal["REAL", "TEST", "SIMULATED", "EXERCISE"] = FieldInfo(alias="dataMode")
+    """Indicator of whether the data is EXERCISE, REAL, SIMULATED, or TEST data:
+
+    EXERCISE: Data pertaining to a government or military exercise. The data
+    may include both real and simulated data.
+
+    REAL: Data collected or produced that pertains to real-world objects,
+    events, and analysis.
+
+    SIMULATED: Synthetic data generated by a model to mimic real-world
+    datasets.
+
+    TEST: Specific datasets used to evaluate compliance with specifications and
+    requirements, and for validating technical, functional, and performance
+    characteristics.
+    """
+
+    source: str
+    """Source of the data."""
+
+    start_time: datetime = FieldInfo(alias="startTime")
+    """
+    The start time or earliest time of the collect or contact request window, in ISO
+    8601 UTC format.
+    """
+
+    type: str
+    """
+    The type of this collect or contact request (DIRECTED SEARCH, DWELL, OBJECT,
+    POL, RATE TRACK, SEARCH, SOI, STARE, TTC, VOLUME SEARCH, etc.).
+    """
+
+    id: Optional[str] = None
+    """Unique identifier of the record, auto-generated by the system."""
+
+    alt: Optional[float] = None
+    """Height above WGS-84 ellipsoid (HAE), in kilometers.
+
+    If an accompanying stopAlt is provided, then alt value can be assumed to be the
+    starting altitude of a volume definition.
+    """
+
+    arg_of_perigee: Optional[float] = FieldInfo(alias="argOfPerigee", default=None)
+    """
+    The argument of perigee is the angle, in degrees, formed between the perigee and
+    the ascending node.
+    """
+
+    az: Optional[float] = None
+    """
+    The expected or directed azimuth angle, in degrees, for search or target
+    acquisition.
+    """
+
+    collect_response: Optional[List[CollectResponseFull]] = FieldInfo(alias="collectResponse", default=None)
+    """CollectResponses associated to request id.
+
+    Read-only details (only used on detail queries, not to be provided on
+    create/update operations).
+    """
+
+    created_at: Optional[datetime] = FieldInfo(alias="createdAt", default=None)
+    """Time the row was created in the database, auto-populated by the system."""
+
+    created_by: Optional[str] = FieldInfo(alias="createdBy", default=None)
+    """
+    Application user who created the row in the database, auto-populated by the
+    system.
+    """
+
+    customer: Optional[str] = None
+    """The customer for this request."""
+
+    dec: Optional[float] = None
+    """
+    The expected or directed declination angle, in degrees, for search or target
+    acquisition.
+    """
+
+    duration: Optional[int] = None
+    """The duration of the collect request, in seconds.
+
+    If both duration and endTime are provided, the endTime is assumed to take
+    precedence.
+    """
+
+    dwell_id: Optional[str] = FieldInfo(alias="dwellId", default=None)
+    """The dwell ID associated with this request.
+
+    A dwell ID is dwell point specific and a DWELL request consist of many dwell
+    point requests.
+    """
+
+    eccentricity: Optional[float] = None
+    """
+    The orbital eccentricity of an astronomical object is a parameter that
+    determines the amount by which its orbit around another body deviates from a
+    perfect circle.
+    """
+
+    el: Optional[float] = None
+    """
+    The expected or directed elevation angle, in degrees, for search or target
+    acquisition.
+    """
+
+    elset: Optional[HistoryRetrieveResponseItemCollectRequestElset] = None
+    """
+    An element set is a collection of Keplerian orbital elements describing an orbit
+    of a particular satellite. The data is used along with an orbit propagator in
+    order to predict the motion of a satellite. The element set, or elset for short,
+    consists of identification data, the classical elements and drag parameters.
+    """
+
+    end_time: Optional[datetime] = FieldInfo(alias="endTime", default=None)
+    """The end time of the collect or contact request window, in ISO 8601 UTC format.
+
+    If no endTime or duration is provided it is assumed the request is either
+    ongoing or that the request is for a specified number of tracks (numTracks). If
+    both duration and endTime are provided, the endTime is assumed to take
+    precedence.
+    """
+
+    epoch: Optional[datetime] = None
+    """Epoch time, in ISO 8601 UTC format, of the orbital elements."""
+
+    es_id: Optional[str] = FieldInfo(alias="esId", default=None)
+    """ID of the UDL Ephemeris Set of the object associated with this request."""
+
+    extent_az: Optional[float] = FieldInfo(alias="extentAz", default=None)
+    """
+    The extent of the azimuth angle, in degrees, from center azimuth to define a
+    spatial volume.
+    """
+
+    extent_el: Optional[float] = FieldInfo(alias="extentEl", default=None)
+    """
+    The extent of the elevation angle, in degrees, from center elevation to define a
+    spatial volume.
+    """
+
+    extent_range: Optional[float] = FieldInfo(alias="extentRange", default=None)
+    """The extent of the range, in km, from center range to define a spatial volume."""
+
+    external_id: Optional[str] = FieldInfo(alias="externalId", default=None)
+    """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.
+    """
+
+    frame_rate: Optional[float] = FieldInfo(alias="frameRate", default=None)
+    """For optical sensors, the frame rate of the camera, in Hz."""
+
+    freq: Optional[float] = None
+    """The estimated or expected emission frequency of the target, in MHz."""
+
+    freq_max: Optional[float] = FieldInfo(alias="freqMax", default=None)
+    """The maximum frequency of interest, in MHz."""
+
+    freq_min: Optional[float] = FieldInfo(alias="freqMin", default=None)
+    """The minimum frequency of interest, in MHz.
+
+    If only minimum frequency is provided it is assumed to be minimum reportable
+    frequency.
+    """
+
+    id_elset: Optional[str] = FieldInfo(alias="idElset", default=None)
+    """ID of the UDL Elset of the object associated with this request."""
+
+    id_manifold: Optional[str] = FieldInfo(alias="idManifold", default=None)
+    """ID of the UDL Manifold Elset of the object associated with this request.
+
+    A Manifold Elset provides theoretical Keplerian orbital elements belonging to an
+    object of interest's manifold describing a possible/theoretical orbit for an
+    object of interest for tasking purposes.
+    """
+
+    id_on_orbit: Optional[str] = FieldInfo(alias="idOnOrbit", default=None)
+    """Unique identifier of the target on-orbit object for this request."""
+
+    id_parent_req: Optional[str] = FieldInfo(alias="idParentReq", default=None)
+    """The unique ID of the collect request record from which this request originated.
+
+    This may be used for cases of sensor-to-sensor tasking, such as tip/cue
+    operations.
+    """
+
+    id_plan: Optional[str] = FieldInfo(alias="idPlan", default=None)
+    """Unique identifier of the parent plan or schedule associated with this request.
+
+    If null, this request is assumed not associated with a plan or schedule.
+    """
+
+    id_sensor: Optional[str] = FieldInfo(alias="idSensor", default=None)
+    """
+    Unique identifier of the requested/scheduled/planned sensor associated with this
+    request. If both idSensor and origSensorId are null then the request is assumed
+    to be a general request for observations or contact on an object, if specified,
+    or an area/volume. In this case, the requester may specify a desired obType.
+    """
+
+    id_state_vector: Optional[str] = FieldInfo(alias="idStateVector", default=None)
+    """
+    ID of the UDL State Vector of the object or central vector associated with this
+    request.
+    """
+
+    inclination: Optional[float] = None
+    """
+    The angle, in degrees, between the equator and the orbit plane when looking from
+    the center of the Earth. Inclination ranges from 0-180 degrees, with 0-90
+    representing posigrade orbits and 90-180 representing retrograde orbits.
+    """
+
+    integration_time: Optional[float] = FieldInfo(alias="integrationTime", default=None)
+    """For optical sensors, the integration time per camera frame, in milliseconds."""
+
+    iron: Optional[int] = None
+    """Inter-Range Operations Number.
+
+    Four-digit identifier used to schedule and identify AFSCN contact support for
+    booster, launch, and on-orbit operations.
+    """
+
+    irradiance: Optional[float] = None
+    """The target object irradiance value."""
+
+    lat: Optional[float] = None
+    """WGS-84 latitude, in degrees.
+
+    -90 to 90 degrees (negative values south of equator). If an accompanying stopLat
+    is provided, then the lat value can be assumed to be the starting latitude of a
+    volume definition.
+    """
+
+    lon: Optional[float] = None
+    """WGS-84 longitude, in degrees.
+
+    -180 to 180 degrees (negative values west of Prime Meridian). If an accompanying
+    stopLon is provided, then lon value can be assumed to be the starting longitude
+    of a volume definition.
+    """
+
+    msg_create_date: Optional[datetime] = FieldInfo(alias="msgCreateDate", default=None)
+    """
+    The timestamp of the external message from which this request originated, if
+    applicable, in ISO8601 UTC format with millisecond precision.
+    """
+
+    msg_type: Optional[str] = FieldInfo(alias="msgType", default=None)
+    """The type of external message from which this request originated."""
+
+    notes: Optional[str] = None
+    """Notes or comments associated with this request."""
+
+    num_frames: Optional[int] = FieldInfo(alias="numFrames", default=None)
+    """
+    For optical sensors, the requested number of frames to capture at each sensor
+    step.
+    """
+
+    num_obs: Optional[int] = FieldInfo(alias="numObs", default=None)
+    """The number of requested observations on the target."""
+
+    num_tracks: Optional[int] = FieldInfo(alias="numTracks", default=None)
+    """The number of requested tracks on the target.
+
+    If numTracks is not provided it is assumed to indicate all possible observations
+    every pass over the request duration or within the request start/end window.
+    """
+
+    ob_type: Optional[str] = FieldInfo(alias="obType", default=None)
+    """
+    Optional type of observation (EO, IR, RADAR, RF-ACTIVE, RF-PASSIVE, OTHER)
+    requested. This field may correspond to a request of a specific sensor, or to a
+    general non sensor specific request.
+    """
+
+    orbit_regime: Optional[str] = FieldInfo(alias="orbitRegime", default=None)
+    """The orbit regime of the target (GEO, HEO, LAUNCH, LEO, MEO, OTHER)."""
+
+    orient_angle: Optional[float] = FieldInfo(alias="orientAngle", default=None)
+    """
+    The magnitude of rotation, in degrees, between the xAngle direction and locally
+    defined equinoctial plane. A positive value indicates clockwise rotation about
+    the sensor boresight vector.
+    """
+
+    origin: Optional[str] = None
+    """
+    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.
+    """
+
+    orig_network: Optional[str] = FieldInfo(alias="origNetwork", default=None)
+    """
+    The originating source network on which this record was created, auto-populated
+    by the system.
+    """
+
+    orig_object_id: Optional[str] = FieldInfo(alias="origObjectId", default=None)
+    """
+    Optional identifier provided by the data source to indicate the target object of
+    this request. This may be an internal identifier and not necessarily map to a
+    valid satellite number.
+    """
+
+    orig_sensor_id: Optional[str] = FieldInfo(alias="origSensorId", default=None)
+    """
+    Optional identifier provided by the source to indicate the sensor identifier
+    requested/scheduled/planned for this request. This may be an internal identifier
+    and not necessarily a valid sensor ID. If both idSensor and origSensorId are
+    null then the request is assumed to be a general request for observations or
+    contact on an object, if specified, or an area/volume. In this case, the
+    requester may specify a desired obType.
+    """
+
+    plan_index: Optional[int] = FieldInfo(alias="planIndex", default=None)
+    """Index number (integer) for records within a collection plan or schedule."""
+
+    polarization: Optional[str] = None
+    """The RF polarization (H, LHC, RHC, V)."""
+
+    priority: Optional[str] = None
+    """
+    The priority of the collect request (EMERGENCY, FLASH, IMMEDIATE, PRIORITY,
+    ROUTINE).
+    """
+
+    ra: Optional[float] = None
+    """
+    The expected or directed right ascension angle, in degrees, for search or target
+    acquisition.
+    """
+
+    raan: Optional[float] = None
+    """
+    Right ascension of the ascending node, or RAAN is the angle as measured in
+    degrees eastwards (or, as seen from the north, counterclockwise) from the First
+    Point of Aries to the ascending node.
+    """
+
+    range: Optional[float] = None
+    """The expected acquisition range or defined center range, in km."""
+
+    rcs: Optional[float] = None
+    """The Radar Cross-Section of the target, in m^2."""
+
+    rcs_max: Optional[float] = FieldInfo(alias="rcsMax", default=None)
+    """The maximum Radar Cross-Section of the target, in m^2."""
+
+    rcs_min: Optional[float] = FieldInfo(alias="rcsMin", default=None)
+    """The minimum Radar Cross-Section of the target, in m^2.
+
+    If only minimum RCS is provided it is assumed to be minimum reportable RCS.
+    """
+
+    reflectance: Optional[float] = None
+    """The fraction of solar energy reflected from target."""
+
+    sat_no: Optional[int] = FieldInfo(alias="satNo", default=None)
+    """Satellite/catalog number of the target on-orbit object for this request."""
+
+    scenario: Optional[str] = None
+    """
+    Pre-coordinated code, direction, or configuration to be executed by the sensor
+    or site for this collect or contact.
+    """
+
+    semi_major_axis: Optional[float] = FieldInfo(alias="semiMajorAxis", default=None)
+    """The average of the periapsis and apoapsis distances, in kilometers.
+
+    For circular orbits, the semimajor axis is the distance between the centers of
+    the bodies.
+    """
+
+    spectral_model: Optional[str] = FieldInfo(alias="spectralModel", default=None)
+    """The spectral model used for the irradiance calculation."""
+
+    srch_inc: Optional[float] = FieldInfo(alias="srchInc", default=None)
+    """The maximum inclination, in degrees, to be used in search operations."""
+
+    srch_pattern: Optional[str] = FieldInfo(alias="srchPattern", default=None)
+    """The search pattern to be executed for this request (e.g.
+
+    PICKET-FENCE, SCAN, etc.).
+    """
+
+    state_vector: Optional[HistoryRetrieveResponseItemCollectRequestStateVector] = FieldInfo(
+        alias="stateVector", default=None
+    )
+    """
+    This service provides operations for querying and manipulation of state vectors
+    for OnOrbit objects. State vectors are cartesian vectors of position (r) and
+    velocity (v) that, together with their time (epoch) (t), uniquely determine the
+    trajectory of the orbiting body in space. J2000 is the preferred coordinate
+    frame for all state vector positions/velocities in UDL, but in some cases data
+    may be in another frame depending on the provider and/or datatype. Please see
+    the 'Discover' tab in the storefront to confirm coordinate frames by data
+    provider.
+    """
+
+    stop_alt: Optional[float] = FieldInfo(alias="stopAlt", default=None)
+    """
+    The stopping HAE WGS-84 height above ellipsoid (HAE), of a volume definition, in
+    kilometers. The stopAlt value is only meaningful if a (starting) alt value is
+    provided.
+    """
+
+    stop_lat: Optional[float] = FieldInfo(alias="stopLat", default=None)
+    """The stopping WGS-84 latitude of a volume definition, in degrees.
+
+    -90 to 90 degrees (negative values south of equator). The stopLat value is only
+    meaningful if a (starting) lat value is provided.
+    """
+
+    stop_lon: Optional[float] = FieldInfo(alias="stopLon", default=None)
+    """The stopping WGS-84 longitude of a volume definition, in degrees.
+
+    -180 to 180 degrees (negative values west of Prime Meridian). The stopLon value
+    is only meaningful if a (starting) lon value is provided.
+    """
+
+    suffix: Optional[str] = None
+    """The (SSN) tasking suffix (A-Z) associated with this request.
+
+    The suffix defines the amount of observational data and the frequency of
+    collection. Note that suffix definitions are sensor type specific.
+    """
+
+    tags: Optional[List[str]] = None
+    """
+    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.
+    """
+
+    target_size: Optional[float] = FieldInfo(alias="targetSize", default=None)
+    """The minimum object (diameter) size, in meters, to be reported."""
+
+    task_category: Optional[int] = FieldInfo(alias="taskCategory", default=None)
+    """The (SSN) tasking category (1-5) associated with this request.
+
+    The tasking category defines the priority of gathering and transmitting the
+    requested observational data. Note that category definitions are sensor type
+    specific.
+    """
+
+    task_group: Optional[str] = FieldInfo(alias="taskGroup", default=None)
+    """The tasking group to which the target object is assigned."""
+
+    task_id: Optional[str] = FieldInfo(alias="taskId", default=None)
+    """Task ID associated with this request.
+
+    A task ID may be associated with a single collect request or may be used to tie
+    together the sub-requests of a full collect, for example a DWELL consisting of
+    many dwell points.
+    """
+
+    transaction_id: Optional[str] = FieldInfo(alias="transactionId", default=None)
+    """
+    Optional identifier to track a commercial or marketplace transaction executed to
+    produce this data.
+    """
+
+    true_anomoly: Optional[float] = FieldInfo(alias="trueAnomoly", default=None)
+    """
+    The true anomaly defines the angular position, in degrees, of the object on it's
+    orbital path as measured from the orbit focal point at epoch. The true anomaly
+    is referenced from perigee.
+    """
+
+    uct_follow_up: Optional[bool] = FieldInfo(alias="uctFollowUp", default=None)
+    """Boolean indicating that this collect request is UCT follow-up."""
+
+    updated_at: Optional[datetime] = FieldInfo(alias="updatedAt", default=None)
+    """Time the row was last updated in the database, auto-populated by the system."""
+
+    updated_by: Optional[str] = FieldInfo(alias="updatedBy", default=None)
+    """
+    Application user who updated the row in the database, auto-populated by the
+    system.
+    """
+
+    vis_mag: Optional[float] = FieldInfo(alias="visMag", default=None)
+    """The estimated or expected visual magnitude of the target, in Magnitudes (M)."""
+
+    vis_mag_max: Optional[float] = FieldInfo(alias="visMagMax", default=None)
+    """
+    The maximum estimated or expected visual magnitude of the target, in Magnitudes
+    (M).
+    """
+
+    vis_mag_min: Optional[float] = FieldInfo(alias="visMagMin", default=None)
+    """
+    The minimum estimated or expected visual magnitude of the target, in Magnitudes
+    (M). If only minimum vismag is provided it is assumed to be minimum reportable
+    vismag.
+    """
+
+    x_angle: Optional[float] = FieldInfo(alias="xAngle", default=None)
+    """
+    The angular distance, in degrees, in the sensor-x direction from scan center
+    defined by the central vector. The specification of xAngle and yAngle defines a
+    rectangle of width 2*xAngle and height 2*yAngle centered about the central
+    vector.
+    """
+
+    y_angle: Optional[float] = FieldInfo(alias="yAngle", default=None)
+    """
+    The angular distance, in degrees, in the sensor-y direction from scan center
+    defined by the central vector. The specification of xAngle and yAngle defines a
+    rectangle of width 2*xAngle and height 2*yAngle centered about the central
+    vector.
+    """
+
+
+class HistoryRetrieveResponseItem(BaseModel):
+    classification_marking: str = FieldInfo(alias="classificationMarking")
+    """Classification marking of the data in IC/CAPCO Portion-marked format."""
+
+    data_mode: Literal["REAL", "TEST", "SIMULATED", "EXERCISE"] = FieldInfo(alias="dataMode")
+    """Indicator of whether the data is EXERCISE, REAL, SIMULATED, or TEST data:
+
+    EXERCISE: Data pertaining to a government or military exercise. The data
+    may include both real and simulated data.
+
+    REAL: Data collected or produced that pertains to real-world objects,
+    events, and analysis.
+
+    SIMULATED: Synthetic data generated by a model to mimic real-world
+    datasets.
+
+    TEST: Specific datasets used to evaluate compliance with specifications and
+    requirements, and for validating technical, functional, and performance
+    characteristics.
+    """
+
+    rec_type: str = FieldInfo(alias="recType")
+    """The type of records that comprise this parent set (COLLECT, CONTACT)."""
+
+    source: str
+    """Source of the data."""
+
+    start_time: datetime = FieldInfo(alias="startTime")
+    """The start time of the plan or schedule, in ISO 8601 UTC format."""
+
+    type: str
+    """The type of this sensor plan/schedule (PLAN, REQUEST, SCHEDULE)."""
+
+    id: Optional[str] = None
+    """Unique identifier of the record, auto-generated by the system."""
+
+    collect_requests: Optional[List[HistoryRetrieveResponseItemCollectRequest]] = FieldInfo(
+        alias="collectRequests", default=None
+    )
+    """The list of collect requests belonging to the SensorPlan.
+
+    Each collect request is associated with a parent SensorPlan via the IdPlan. If
+    provided, the list must have the same size as reqTotal.
+    """
+
+    created_at: Optional[datetime] = FieldInfo(alias="createdAt", default=None)
+    """Time the row was created in the database, auto-populated by the system."""
+
+    created_by: Optional[str] = FieldInfo(alias="createdBy", default=None)
+    """
+    Application user who created the row in the database, auto-populated by the
+    system.
+    """
+
+    customer: Optional[str] = None
+    """The customer for this plan or schedule."""
+
+    end_time: Optional[datetime] = FieldInfo(alias="endTime", default=None)
+    """The end time of the plan or schedule, in ISO 8601 UTC format."""
+
+    id_sensor: Optional[str] = FieldInfo(alias="idSensor", default=None)
+    """
+    Unique identifier of the requested/schedule/planned sensor associated with this
+    request.
+    """
+
+    name: Optional[str] = None
+    """Name associated with this plan or schedule."""
+
+    origin: Optional[str] = None
+    """
+    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.
+    """
+
+    orig_network: Optional[str] = FieldInfo(alias="origNetwork", default=None)
+    """
+    The originating source network on which this record was created, auto-populated
+    by the system.
+    """
+
+    orig_sensor_id: Optional[str] = FieldInfo(alias="origSensorId", default=None)
+    """
+    Optional identifier provided by the source to indicate the sensor identifier
+    requested/scheduled/planned for this request. This may be an internal identifier
+    and not necessarily a valid sensor ID.
+    """
+
+    purpose: Optional[str] = None
+    """The purpose/description of this plan or schedule."""
+
+    req_total: Optional[int] = FieldInfo(alias="reqTotal", default=None)
+    """The total number of requests contained in this plan or schedule.
+
+    Value of this field must match the size of collectRequest list if the list is
+    provided and can be null or any value otherwise.
+    """
+
+    sen_network: Optional[str] = FieldInfo(alias="senNetwork", default=None)
+    """The sensor or ground network associated with this plan or schedule."""
+
+    status: Optional[str] = None
+    """
+    The status of this plan or schedule (ACCEPTED, APPROVED, COMPLETED, PROPOSED,
+    REJECTED, REQUESTED, SCHEDULED).
+    """
+
+    tags: Optional[List[str]] = None
+    """
+    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.
+    """
+
+    updated_at: Optional[datetime] = FieldInfo(alias="updatedAt", default=None)
+    """Time the row was updated in the database, auto-populated by the system."""
+
+    updated_by: Optional[str] = FieldInfo(alias="updatedBy", default=None)
+    """
+    Application user who updated the row in the database, auto-populated by the
+    system.
+    """
+
+
+HistoryRetrieveResponse: TypeAlias = List[HistoryRetrieveResponseItem]