--- title: "POST /udl/airfieldstatus" method: POST path: "/udl/airfieldstatus" tags: ["Site"] --- # POST /udl/airfieldstatus `POST /udl/airfieldstatus` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/airfieldstatus` - Auth: none declared Service operation to take a single airfield status record as a POST body and ingest into the database. This operation is not intended to be used for automated feeds into UDL. Data providers should contact the UDL team for specific role assignments and for instructions on setting up a permanent feed through an alternate mechanism. ## Request body - AirfieldStatusIngest: The airfield status contains dynamic data of an airfield's capabilities. - `id` string: Unique identifier of the record, auto-generated by the system. - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format. - `idAirfield` string, required: Unique identifier of the Airfield for which this status is referencing. - `altAirfieldId` string: Alternate airfield identifier provided by the source. - `surveyDate` string, date-time: The date the airfield survey was performed, in ISO 8601 UTC format with millisecond precision. - `reviewedBy` string: The name of the person who reviewed the airfield survey. - `reviewedDate` string, date-time: The date the airfield survey was reviewed, in ISO 8601 UTC format with millisecond precision. - `approvedBy` string: The name of the person who approved the airfield survey review. - `approvedDate` string, date-time: The date that survey review changes were approved for this airfield, in ISO 8601 UTC format with millisecond precision. - `passengerServiceMOG` integer: Maximum on ground (MOG) number of high-reach/wide-body passenger aircraft that can be serviced simultaneously based on spacing and manpower at the time of status. - `fleetServiceMOG` integer: Maximum on ground (MOG) number of fleet aircraft that can be serviced simultaneously based on spacing and manpower at the time of status. - `cargoMOG` integer: Maximum on ground (MOG) number of high-reach/wide-body cargo aircraft that can be serviced simultaneously based on spacing and manpower at the time of status. - `fuelMOG` integer: Maximum on ground (MOG) number of aircraft that can be simultaneously refueled based on spacing and manpower at the time of status. - `fuelTypes` string[]: Array of fuel types available at the airfield. This array must be the same length as fuelQtys. - `fuelQtys` number[]: Array of quantities for each fuel type at the airfield, in kilograms. The values in this array must correspond to the position index in fuelTypes. This array must be the same length as fuelTypes. - `mxMOG` integer: Maximum on ground (MOG) number of aircraft that can be simultaneously ground handled for standard maintenance based on spacing and manpower at the time of status. - `operatingMOG` integer: Maximum on ground (MOG) number of aircraft due to items not directly related to the airfield infrastructure or aircraft servicing capability based on spacing and manpower at the time of status. - `numCOG` integer: The number of aircraft that are currently on ground (COG) at the airfield. - `wideWorkingMOG` integer: Maximum on ground (MOG) number of working wide-body aircraft based on spacing and manpower at the time of status. Additional information about this field as it pertains to specific aircraft type may be available in an associated SiteOperations record. - `wideParkingMOG` integer: Maximum on ground (MOG) number of parking wide-body aircraft based on spacing and manpower at the time of status. Additional information about this field as it pertains to specific aircraft type may be available in an associated SiteOperations record. - `narrowWorkingMOG` integer: Maximum on ground (MOG) number of working narrow-body aircraft based on spacing and manpower at the time of status. - `narrowParkingMOG` integer: Maximum on ground (MOG) number of parking narrow-body aircraft based on spacing and manpower at the time of status. - `mheTypes` string[]: Array of material handling equipment types at the airfield. This array must be the same length as mheQtys. - `mheQtys` integer[]: Array of quantities for each material handling equipment types at the airfield. The values in this array must correspond to the position index in mheTypes. This array must be the same length as mheTypes. - `medCap` string: The level of medical support and capabilities available at the airfield. - `arffCat` string: The category of aircraft rescue and fire fighting (ARFF) services that are currently available at the airfield. Entries should include the code (FAA or ICAO) and the category. - `gseTime` integer: The expected time to receive ground support equipment (e.g. power units, air units, cables, hoses, etc.), in minutes. - `priRwyNum` string: The number or ID of primary runway at the airfield. - `rwyCondReading` integer: The primary runway condition reading value used for determining runway braking action, from 0 to 26. A value of 0 indicates braking action is poor or non-existent, where a value of 26 indicates braking action is good. - `rwyFrictionFactor` integer: The primary runway friction factor which is dependent on the surface friction between the tires of the aircraft and the runway surface, from 0 to 100. A lower number indicates less friction and less braking response. - `rwyMarkings` string[]: Array of markings currently on the primary runway. - `message` string: Description of the current status of the airfield. - `priFreq` number, double: The primary frequency which the airfield is currently operating, in megahertz. - `slotTypesReq` string[]: Array of slot types that an airfield requires a particular aircraft provide in order to consume a slot at this location. - `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. - `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. ## Response `201` Success ## Other responses - `204`: Success: An existing record was updated - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `404`: Item Not Found - `405`: Method Not Allowed - `415`: MediaType Unsupported - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2025-04-16** `75f764c843a9`: 1 breaking, 4 warning, 7 info - request body became required - the `fuelTypes/items/` request property's maxLength was set to `32` - the `mheTypes/items/` request property's maxLength was set to `32` - the `rwyMarkings/items/` request property's maxLength was set to `64` - …8 more [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/airfieldstatus/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)