--- title: "POST /filedrop/udl-orbittrack" method: POST path: "/filedrop/udl-orbittrack" tags: ["Track"] --- # POST /filedrop/udl-orbittrack `POST /filedrop/udl-orbittrack` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/filedrop/udl-orbittrack` - Auth: none declared Service operation to take multiple orbit track records as a POST body and ingest into the database. This operation is intended to be used for automated feeds into UDL. A specific role is required to perform this service operation. Please contact the UDL team for assistance. ## Request body - OrbitTrackIngest[] - `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. - `idOnOrbit` string: Unique identifier of the target on-orbit object, if correlated. - `satNo` integer: Satellite/catalog number of the target on-orbit object. - `origObjectId` string: Optional identifier provided by observation source to indicate the target on-orbit object of this track. This may be an internal identifier and not necessarily a valid satellite number. - `idElset` string: Unique identifier of the Elset associated with this object. - `ts` string, date-time, required: Track timestamp in ISO8601 UTC format, with microsecond precision. - `lat` number, double, required: WGS-84 latitude of the track object subpoint, in degrees. -90 to 90 degrees (negative values south of equator). - `lon` number, double, required: WGS-84 longitude of the track object subpoint, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `alt` number, double: Track point altitude relative to WGS-84 ellipsoid, in meters. - `rdfRF` number, double: Radio frequency of the track, measured in megahertz (MHz). - `callSign` string: International radio call sign assigned to the track. This is an 8-character alphanumeric code. - `rptNum` string: Report number received from the reporting source for this track. - `objIdent` 'ASSUMED FRIEND' | 'FRIEND' | 'HOSTILE' | 'NEUTRAL' | 'PENDING' | 'SUSPECT' | 'UNKNOWN': The estimated identity of the track object (ASSUMED FRIEND, FRIEND, HOSTILE, NEUTRAL, PENDING, SUSPECT, UNKNOWN): ASSUMED FRIEND: Track assumed to be a friend due to the object characteristics, behavior, and/or origin. FRIEND: Track object supporting friendly forces and belonging to a declared friendly nation or entity. HOSTILE: Track object belonging to an opposing nation, party, group, or entity deemed to contribute to a threat to friendly forces or their mission due to its behavior, characteristics, nationality, or origin. NEUTRAL: Track object whose characteristics, behavior, nationality, and/or origin indicate that it is neither supporting nor opposing friendly forces or their mission. PENDING: Track object which has not been evaluated. SUSPECT: Track object deemed potentially hostile due to the object characteristics, behavior, nationality, and/or origin. UNKNOWN: Track object which has been evaluated and does not meet criteria for any standard identity. - `identAmp` string: Additional track object identity/status information, typically used for EXERCISE identity amplification (FAKER, JOKER, KILO, TRAVELLER, ZOMBIE): FAKER: Friendly track, object, or entity acting as an exercise hostile. JOKER: Friendly track, object, or entity acting as an exercise suspect. KILO: Friendly high-value object. TRAVELLER: Suspect land or surface track following a recognized traffic route. ZOMBIE: Suspect track, object, or entity of special interest. - `satStatus` string: Status of the satellite. - `objectType` 'DEBRIS' | 'MANNED' | 'PAYLOAD' | 'PLATFORM' | 'ROCKET BODY' | 'UNKNOWN': The on-orbit category assigned to this track object (DEBRIS, MANNED, PAYLOAD, PLATFORM, ROCKET BODY, UNKNOWN). - `countryCode` string: The country code. This value is typically the ISO 3166 Alpha-2 two-character country code, however it can also represent various consortiums that do not appear in the ISO document. The code must correspond to an existing country in the UDL’s country API. Call udl/country/{code} to get any associated FIPS code, ISO Alpha-3 code, or alternate code values that exist for the specified country code. - `decay` number, double: Predicted change in Mean Motion (velocity) in radians/herg^2. herg is a unit of time measure equal to 806.8120769 seconds, and is the orbital period of an imaginary satellite rotating about the Earth at zero altitude. - `charlieLine` string: One-line Charlie elements set. - `aouType` string: The Area of Uncertainty (AoU) type (BEARING, ELLIPSE, OTHER) definition. This type defines the elements of the aouData array and is required if aouData is not null. See the aouData field definition for specific information. - `aouData` number[]: Three element array representing an Area of Uncertainty (AoU). The array element definitions and units are type specific depending on the aouType specified in this record: ELLIPSE: brg - orientation in degrees of the ellipse a1 - semi-major axis in meters a2 - semi-minor axis in meters BEARING (BEARING BOX or MTST BEARING BOX): brg - orientation in degrees of the bearing box a1 - length of bearing box in meters a2 - half-width of bearing box in meters OTHER (All other type values): brg - line of bearing in degrees true a1 - bearing error in degrees a2 - estimated range in meters. - `spd` number, double: Track object speed, in km/sec. - `angElev` number, double: The angle formed between the line of sight of the observer and the horizon at track timestamp, in degrees. The angular range is -90 to 90, with negative values representing angle of depression. - `cntnmnt` number, double: The Area Of Uncertainty (AOU) percentage (0 - 100) containment value. The percentage of time (90%) that the estimated area of uncertainty will cover the true position of the track object. - `xref` string: Source cross-reference code for the command that originated the track report. - `chXRef` string: The cross-reference code of the channel on which this track report was received, if the report came over a comms channel. - `amplification` string: Free-form remarks entered for the satellite. - `iff` string: A text amplifier displaying IFF/SIF/AIS Identification modes and codes. - `reinforced` boolean: Flag indicating that this track represents a reinforced object or group. Based on MIL-STD-2525 symbology definitions. - `reduced` boolean: Flag indicating that this track represents a reduced object or group. Based on MIL-STD-2525 symbology definitions. - `hq` boolean: Flag indicating that this track represents a headquarters object. Based on MIL-STD-2525 symbology definitions. - `dummy` boolean: Flag indicating that this track represents a dummy object or group. Identifies offensive or defensive units, equipment and/or installations intended to draw the enemy's attention away from the area of the main attack. Based on MIL-STD-2525 symbology definitions. - `taskForce` boolean: Flag indicating that this track represents a task force. Based on MIL-STD-2525 symbology definitions. - `feint` boolean: Flag indicating that this track represents a feint object or group. Identifies offensive or defensive units, equipment and/or installations intended to draw the enemy's attention away from the area of the main attack. Based on MIL-STD-2525 symbology definitions. - `installation` boolean: Flag indicating that this track represents an installation. Based on MIL-STD-2525 symbology definitions. - `vehType` string: The type of vehicle with which the device is associated. Based on MIL-STD-2525 symbology definitions. - `trkId` string: UUID identifying the track, which should remain the same on subsequent tracks of the same object. - `trackSensors` TrackSensorIngest[]: TrackSensor Collection. - `range` number, double, required: The track object range from the observing sensor, in kilometers. - `az` number, double, required: The observing sensor azimuth angle, in degrees and topocentric frame. - `sensorNumber` integer: Number assigned to this sensor. Since there is no authoritative numbering scheme, these numbers sometimes collide across sensors (especially commercial sensors). It is therefore not a unique identifier. - `sensorName` string: Unique name of this sensor. - `missionNumber` string: The mission number which produced this track observation. - `minRangeLimit` number, double: Minimum range measurement capability of the sensor, in kilometers. - `sensorFOVType` 'BUTTERFLY' | 'CONE ANGULAR' | 'CONE DISTANCE' | 'HORIZON TO HORIZON' | 'UNKNOWN': The field of view (FOV) type (Butterfly, Cone Angular, Cone Distance, Horizon to Horizon, Unknown) employed by the sensor observing this object. - `createdAt` string, date-time: Time the row was created in the database. - `createdBy` string: Application user who created the row in the database. - `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. - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. ## Response `202` Accepted ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2026-04-09** `bd17bc53681e`: 1 info - added the non-success response with the status `429` - **2025-09-26** `45631f9bb3f0`: 1 breaking - the `items/createdBy` request property's minLength was increased from `0` to `1` - **2025-04-16** `75f764c843a9`: 1 info - the endpoint scheme security `BasicAuth` was removed from the API [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/filedrop/udl-orbittrack/post.md) --- [API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)