--- title: "POST /filedrop/udl-flightplan" method: POST path: "/filedrop/udl-flightplan" tags: ["AirOperations"] --- # POST /filedrop/udl-flightplan `POST /filedrop/udl-flightplan` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/filedrop/udl-flightplan` - Auth: none declared Service operation to take one or many flight plan 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 - FlightPlanIngest[] - `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. - `amcMissionId` string: Air Mobility Command (AMC) mission identifier according to Mobility Air Forces (MAF) encode/decode procedures. - `idSortie` string: The UDL unique identifier of the aircraft sortie associated with this flight plan. - `idAircraft` string: The UDL unique identifier of the aircraft associated with this flight plan. - `legNum` integer: The leg number of this flight plan. - `idDepAirfield` string: The UDL unique identifier of the departure airfield associated with this flight plan. - `depAirfield` string, required: The airfield identifier of the departure location, International Civil Aviation Organization (ICAO) code preferred. - `idArrAirfield` string: The UDL unique identifier of the arrival airfield associated with this flight plan. - `arrAirfield` string, required: The airfield identifier of the arrival location, International Civil Aviation Organization (ICAO) code preferred. - `externalId` string: The source ID of the flight plan from the generating system. - `genTS` string, date-time, required: The generation time of this flight plan in ISO 8601 UTC format, with millisecond precision. - `aircraftMDS` string: The aircraft Model Design Series (MDS) designation (e.g. E-2C HAWKEYE, F-15 EAGLE, KC-130 HERCULES, etc.) of the aircraft associated with this flight plan. Intended as, but not constrained to, MIL-STD-6016 environment dependent specific type designations. - `tailNumber` string: The tail number of the aircraft associated with this flight plan. - `callSign` string: The call sign assigned to the aircraft for this flight plan. - `status` string: Status of this flight plan (e.g., ACTIVE, APPROVED, PLANNED, etc.). - `wxValidStart` string, date-time: The date and time the weather valid period begins in ISO 8601 UTC format, with millisecond precision. - `wxValidEnd` string, date-time: The date and time the weather valid period ends in ISO 8601 UTC format, with millisecond precision. - `estDepTime` string, date-time: The estimated time of departure for the aircraft, in ISO 8601 UTC format, with millisecond precision. - `dragIndex` number, double: The percent degrade due to drag for this aircraft. - `fuelDegrade` number, double: The fuel degrade percentage used for this mission. - `opWeight` number, double: Operating weight of the aircraft in pounds. - `msnIndex` number, double: The mission index value for this mission. The mission index is the ratio of time-related cost of aircraft operation to the cost of fuel. - `rampFuel` number, double: Total of all fuel required to complete the flight in pounds, including fuel to be dispensed on a refueling mission. - `taxiFuel` number, double: Fuel required to start engines and taxi to the end of the runway in pounds. - `takeoffFuel` number, double: Fuel at takeoff, which is calculated as the ramp fuel minus the taxi fuel in pounds. - `climbFuel` number, double: Fuel required from brake release to Top of Climb in pounds. - `climbTime` string: Time required from brake release to Top of Climb expressed as HH:MM. - `holdDownFuel` number, double: Additional fuel burned at Top of Climb in pounds. - `tocIceFuel` number, double: Additional fuel burned at Top of Climb for icing in pounds. - `tocFuel` number, double: Fuel remaining at Top of Climb in pounds. - `enrouteFuel` number, double: Fuel required to fly from Top of Climb to Top of Descent in pounds. - `enrouteTime` string: Time required to fly from Top of Climb to Top of Descent expressed as HH:MM. - `thunderAvoidFuel` number, double: Additional fuel burned at Top of Descent for thunderstorm avoidance in pounds. - `todIceFuel` number, double: Additional fuel burned at Top of Descent for icing in pounds. - `opConditionFuel` number, double: Additional fuel burned at Top of Descent for the operational condition in pounds. - `todFuel` number, double: Fuel remaining at Top of Descent in pounds. - `earlyDescentFuel` number, double: Additional fuel burned at landing/missed approach for an early descent in pounds. - `arrIceFuel` number, double: Additional fuel burned at landing/missed approach for icing during arrival in pounds. - `holdFuel` number, double: Additional fuel burned at the destination for holding in pounds. - `holdTime` string: Additional time for holding at the destination expressed as HH:MM. - `appLandingFuel` number, double: Fuel burned from the initial approach point to landing in pounds. - `burnedFuel` number, double: Fuel planned to be burned during the flight in pounds. - `landingFuel` number, double: Fuel planned to be remaining on the airplane at landing in pounds. - `minDivertFuel` number, double: The minimum fuel on board required to divert in pounds. - `arrAlternate1Fuel` number, double: Fuel required to fly to alternate landing site 1 and land in pounds. - `arrAlternate2Fuel` number, double: Fuel required to fly to alternate landing site 2 and land in pounds. - `contingencyFuel` number, double: The amount of contingency fuel in pounds. - `reserveFuel` number, double: The amount of reserve fuel in pounds. - `depressFuel` number, double: The depressurization fuel required to fly from the Equal Time Point to the Last Suitable/First Suitable airfield at depressurization altitude in pounds. - `unusableFuel` number, double: The amount of unusable fuel in pounds. - `unidentExtraFuel` number, double: The amount of unidentified extra fuel required to get to min landing in pounds. - `identExtraFuel` number, double: The amount of identified extra fuel carried and not available in the burn plan in pounds. - `remAlternate1Fuel` number, double: Total fuel remaining at alternate landing site 1 in pounds. - `remAlternate2Fuel` number, double: Total fuel remaining at alternate landing site 2 in pounds. - `enduranceTime` string: Total endurance time based on the fuel on board expressed as HH:MM. - `sid` string: Name of the planned Standard Instrument Departure (SID) procedure. - `star` string: Name of the planned Standard Terminal Arrival (STAR) procedure. - `gpsRAIM` string: The GPS Receiver Autonomous Integrity Monitoring (RAIM) message. A RAIM system assesses the integrity of the GPS signals. This system predicts outages for a specified geographical area. These predictions are based on the location, path, and scheduled GPS satellite outages. - `depRunway` string: The departure runway for this flight. - `arrRunway` string: The arrival runway for this flight. - `routeString` string: The 1801 fileable route of flight string for this flight. The route of flight string contains route designators, significant points, change of speed/altitude, change of flight rules, and cruise climbs. - `countryCodes` string[]: Array of country codes for the countries overflown during this flight in ISO 3166-1 Alpha-2 format. - `etopsRating` string: The Extended Operations (ETOPS) rating used to calculate this flight plan. - `etopsAirfields` string[]: Array of Extended Operations (ETOPS) adequate landing airfields that are within the mission region. - `etopsAltAirfields` string[]: Array of Extended Operations (ETOPS) alternate suitable landing airfields that are within the mission region. - `etopsValWindow` string: The Extended Operations (ETOPS) validity window for the alternate airfield. - `plannerRemark` string: Remarks from the planners concerning this flight plan. - `cargoRemark` string: Remarks about the planned cargo associated with this flight plan. - `windFac1` number, double: Wind factor for the first half of the route. This is the average wind factor from first Top of Climb to the mid-time of the entire route in knots. A positive value indicates a headwind, while a negative value indicates a tailwind. - `windFac2` number, double: Wind factor for the second half of the route. This is the average wind factor from the mid-time of the entire route to last Top of Descent in knots. A positive value indicates a headwind, while a negative value indicates a tailwind. - `windFacAvg` number, double: Average wind factor from Top of Climb to Top of Descent in knots. A positive value indicates a headwind, while a negative value indicates a tailwind. - `avgTempDev` number, double: Average temperature deviation of the primary, divert, and alternate path for the route between first Top of Climb and last Top of Descent in degrees Celsius. - `atcAddresses` string[]: Array of Air Traffic Control (ATC) addresses. - `originator` string: Air Traffic Control address filing the flight plan. - `numAircraft` integer: The number of aircraft flying this flight plan. - `flightRules` string: The flight rules this flight plan is being filed under. - `flightType` string: The type of flight (MILITARY, CIVILIAN, etc). - `initialCruiseSpeed` string: A character string representation of the initial filed cruise speed for this flight (prepended values of K, N, and M represent kilometers per hour, knots, and Mach, respectively). - `initialFlightLevel` string: A character string representation of the initial filed altitude level for this flight (prepended values of F, S, A, and M represent flight level in hundreds of feet, standard metric level in tens of meters, altitude in hundreds of feet, and altitude in tens of meters, respectively). - `arrAlternate1` string: The first designated alternate arrival airfield, International Civil Aviation Organization (ICAO) code preferred. - `arrAlternate2` string: The second designated alternate arrival airfield, International Civil Aviation Organization (ICAO) code preferred. - `depAlternate` string: The designated alternate departure airfield, International Civil Aviation Organization (ICAO) code preferred. - `wakeTurbCat` string: The wake turbulence category for this flight. The categories are assigned by the International Civil Aviation Organization (ICAO) and are based on maximum certified takeoff mass for the purpose of separating aircraft in flight due to wake turbulence. Valid values include LIGHT, MEDIUM, LARGE, HEAVY, and SUPER. - `equipment` string: The list of equipment on the aircraft as defined in the Flight Information Publications (FLIP) General Planning (GP) manual. - `notes` string: Additional remarks for air traffic control for this flight. - `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. - `sourceDL` string: The source data library from which this record was received. This could be a remote or tactical UDL or another data library. If null, the record should be assumed to have originated from the primary Enterprise UDL. - `source` string, required: Source of the data. - `origin` string: Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin. - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system. - `dataMode` 'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE', required: Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data: REAL: Data collected or produced that pertains to real-world objects, events, and analysis. TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics. EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data. SIMULATED: Synthetic data generated by a model to mimic real-world datasets. - `airRefuelEvents` FlightPlanAirRefuelEventsIngest[]: Collection of air refueling events occurring on this flight. - `arDegrade` number, double: Additional degrade for air refueling, cumulative with fuelDegrade field percent. - `arNum` integer: The number of this air refueling event within the flight plan. - `arExchangedFuel` number, double: Fuel onloaded (use positive numbers) or fuel offloaded (use negative numbers) in pounds. - `divertFuel` number, double: Fuel required to fly from air refueling exit point to air refueling divert alternate airfield in pounds. - `exitFuel` number, double: Fuel remaining at the air refueling exit in pounds. - `flightPlanMessages` FlightPlanMessagesIngest[]: Collection of messages associated with this flight plan indicating the severity, the point where the message was generated, the path (Primary, Alternate, etc.), and the text of the message. - `severity` string: The severity of the message. - `wpNum` string: The waypoint number for which the message was generated, or enter "PLAN" for a message impacting the entire route. - `routePath` string: The flight path that generated the message (PRIMARY, ALTERNATE, etc.). - `msgText` string: The text of the message. - `flightPlanWaypoints` FlightPlanWaypointsIngest[]: Collection of waypoints associated with this flight plan. - `type` string, required: Points are designated by type as either a comment point or a waypoint. A comment point conveys important information about the point for pilots but is not entered into a flight management system. A waypoint is a point that is entered into a flight management system and/or filed with Air Traffic Control. - `waypointName` string, required: Name of the point. The name of a comment point identifies important information about that point, e.g. Top of Climb. The name of a waypoint identifies the location of that point. - `waypointNum` integer: The waypoint number on the route. Comment points do not get a waypoint number. - `airway` string: The flight path flown for this leg. - `arpt` string: Point identifying an air refueling track/anchor or fixed track. - `lat` number, double: WGS84 latitude of the point location, in degrees. -90 to 90 degrees (negative values south of equator). - `lon` number, double: WGS84 longitude of the point location, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `arId` string: The ID of the air refueling track/anchor or fixed track. - `navaid` string: Navigational Aid (NAVAID) identification code. - `tacanChannel` string: Tactical Air Navigation (TACAN) channel for the Navigational Aid (NAVAID). - `vorFreq` number, double: VHF Omni-directional Range (VOR) frequency for the Navigational Aid (NAVAID) in megahertz. - `turbCat` string: The turbulence intensity classification for this flight (LIGHT, MODERATE, etc). - `iceCat` string: The icing intensity classification for this flight (LIGHT, MODERATE, etc). - `thunderCat` string: The thunderstorm intensity classification for this flight (LIGHT, MODERATE, etc). - `alt` number, double: Altitude of a level, point, or object measured in feet above mean sea level. - `tempDev` number, double: Average temperature deviation from standard day profile for this leg in degrees Celsius. - `legFuelDegrade` number, double: The fuel degrade percentage used for this leg. - `legMach` number, double: The average Mach speed for this leg. - `legMsnIndex` number, double: The mission index value for this leg. The mission index is the ratio of time-related cost of aircraft operation to the cost of fuel. - `legDragIndex` number, double: The percent degrade due to drag for this aircraft for this leg. - `avgCalAirspeed` number, double: The average calibrated airspeed (CAS) for this leg in knots. - `avgTrueAirspeed` number, double: The average true airspeed (TAS) for this leg in knots. - `avgGroundSpeed` number, double: The average ground speed for this leg in knots. - `priFreq` number, double: The primary UHF radio frequency used for the air refueling track or anchor in megahertz. - `pointWindDir` number, double: The wind direction at this specific point in degrees from true north. - `pointWindSpeed` number, double: The wind velocity at this specific point in knots. - `avgWindDir` number, double: The average wind direction for this leg in degrees from true north. - `avgWindSpeed` number, double: The average wind speed for this leg in knots. - `legWindFac` number, double: The wind factor for this leg in knots. A positive value indicates a headwind, while a negative value indicates a tailwind. - `avgDriftAng` number, double: The average drift angle for this leg in degrees from true north. - `secFreq` number, double: The secondary UHF radio frequency used for the air refueling track or anchor in megahertz. - `magCourse` number, double: The magnetic course at leg midpoint in degrees from true north. - `trueCourse` number, double: The true course at leg midpoint in degrees from true north. - `magHeading` number, double: The magnetic heading at leg midpoint in degrees from true north. - `aaTacanChannel` string: The air-to-air Tactical Air Navigation (TACAN) channels used by the receiver/tanker during air refueling. - `zoneDistance` number, double: The zone/leg distance flown in nautical miles. - `totalFlownDistance` number, double: The total distance flown to this waypoint calculated from point of departure in nautical miles. - `totalRemDistance` number, double: The total distance remaining from this waypoint to the point of arrival in nautical miles. - `zoneTime` number, double: The time to fly this zone/leg in minutes. - `totalTime` string: The total time accumulated from takeoff to this waypoint expressed as HH:MM. - `totalTimeRem` string: The total time remaining from this waypoint to the point of arrival expressed as HH:MM. - `zoneFuel` number, double: The amount of fuel used on this zone/leg in pounds. - `totalUsedFuel` number, double: The total fuel used to this waypoint from point of departure in pounds. - `totalRemFuel` number, double: The total fuel remaining at this waypoint in pounds. - `exchangedFuel` number, double: The amount of fuel onloaded or offloaded at this waypoint in pounds (negative value for offload). - `airDistance` number, double: The air distance of this leg in nautical miles. - `totalAirDistance` number, double: The total air distance to this waypoint in nautical miles. - `totalWeight` number, double: The total weight of the aircraft at this waypoint in pounds. - `eta` string, date-time: Estimated Time of Arrival (ETA) at this waypoint in ISO 8601 UTC format, with millisecond precision. - `ata` string, date-time: Actual Time of Arrival (ATA) at this waypoint in ISO 8601 UTC format, with millisecond precision. - `fuelFlow` number, double: The leg fuel flow in pounds per hour. - `legAlternate` string: The planned alternate leg based on user-defined constraints, International Civil Aviation Organization (ICAO) code preferred. - `magVar` number, double: The magnetic variation for this leg in degrees. - `dayLowAlt` number, double: The day low level altitude in feet above sea level for the leg ending at this waypoint. - `nightLowAlt` number, double: The night low level altitude in feet above sea level for the leg ending at this waypoint. - `nvgLowAlt` number, double: The night vision goggle low level altitude in feet above sea level for the leg ending at this waypoint. - `flightPlanPointGroups` FlightPlanPointGroupsIngest[]: Collection of point groups generated for this flight plan. Groups include point sets for Extended Operations (ETOPS), Critical Fuel Point, and Equal Time Point (ETP). - `pointGroupName` string: Name of the point group, usually Extended Operations (ETOPS), Critical Fuel Point, and Equal Time Point (ETP) sections. - `worstFuelCase` string: Specifies which Point Group case requires the most fuel. - `lsafName` string: Name of the last suitable airfield, International Civil Aviation Organization (ICAO) code preferred. - `lsafDistance` number, double: Distance from the Equal Time Point (ETP) to the last suitable airfield in nautical miles. - `fsafDistance` number, double: Distance from the Equal Time Point (ETP) to the first suitable airfield in nautical miles. - `etopsDistance` number, double: Distance from the Extended Operations (ETOPS) point to the recovery airfield in nautical miles. - `lsafTime` string: Time to fly from the Equal Time Point (ETP) to the last suitable airfield expressed in HH:MM format. - `fsafTime` string: Time to fly from the Equal Time Point (ETP) to the first suitable airfield expressed in HH:MM format. - `etopsTime` string: Time to fly from the Extended Operations (ETOPS) point to the recovery airfield expressed in HH:MM format. - `lsafAvgWindFactor` number, double: Average wind factor from the Equal Time Point (ETP) to the last suitable airfield in knots. - `fsafAvgWindFactor` number, double: Average wind factor from the Equal Time Point (ETP) to the first suitable airfield in knots. - `etopsAvgWindFactor` number, double: Average wind factor from the Extended Operations (ETOPS) point to the recovery airfield in knots. - `lsafTempDev` number, double: Temperature deviation from the Equal Time Point (ETP) to the last suitable airfield in degrees Celsius. - `fsafTempDev` number, double: Temperature deviation from the Equal Time Point (ETP) to the first suitable airfield in degrees Celsius. - `etopsTempDev` number, double: Temperature deviation from the Extended Operations (ETOPS) point to the recovery airfield in degrees Celsius. - `lsafReqFuel` number, double: Fuel required to fly from the Equal Time Point (ETP) to the last suitable airfield in pounds. - `fsafReqFuel` number, double: Fuel required to fly from the Equal Time Point (ETP) to the first suitable airfield in pounds. - `etopsReqFuel` number, double: Fuel required to fly from the Extended Operations (ETOPS) point to the recovery airfield in pounds. - `fromTakeoffTime` string: Total time from takeoff when the point is reached expressed in HH:MM format. - `plannedFuel` number, double: Amount of planned fuel on board when the point is reached in pounds. - `fuelCalcAlt` number, double: Flight level of the point at which the fuel was calculated in feet. - `fuelCalcSpd` number, double: True airspeed at which the fuel was calculated in knots. - `avgFuelFlow` number, double: Average fuel flow at which the fuel was calculated in pounds per hour. - `flightPlanPoints` FlightPlanPointsIngest[]: Array of point data for this Point Group. - `pointName` string: Name of this point. - `fppLat` number, double: WGS84 latitude of the point location, in degrees. -90 to 90 degrees (negative values south of equator). - `fppLon` number, double: WGS84 longitude of the point location, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `fppEta` string, date-time: Estimated Time of Arrival (ETA) at this point in ISO 8601 UTC format, with millisecond precision. - `fppReqFuel` number, double: Fuel required at this point to execute an Equal Time Point (ETP) or Extended Operations (ETOPS) plan in pounds. ## 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-04-16** `75f764c843a9`: 2 info - the endpoint scheme security `BasicAuth` was removed from the API - added the new optional request property `items/status` [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/filedrop/udl-flightplan/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)