--- title: "POST /udl/surface" method: POST path: "/udl/surface" tags: ["Site"] --- # POST /udl/surface `POST /udl/surface` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/surface` - Auth: none declared Service operation to take a single Surface as a POST body and ingest into the database. A specific role is required to perform this service operation. Please contact the UDL team for assistance. ## Request body - SurfaceIngest: Surface information contains properties related to an airfield's runway, taxiway, and parking. The surface types and characteristics can dictate the airfield's capability of hosting a specific aircraft. - `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. - `name` string, required: The surface name or identifier. - `type` string, required: The surface type of this record (e.g. RUNWAY, TAXIWAY, PARKING). - `idSite` string: The unique identifier of the Site record that contains location information about this surface. - `altSiteId` string: Alternate site identifier provided by the source. - `primary` boolean: Flag indicating this is the primary runway. Applicable for runway surface types only. - `lengthFt` number, double: The length of the surface type, in feet. Applicable for runway and parking surface types. - `ldaFt` number, double: The landing distance available for the runway, in feet. Applicable for runway surface types only. - `widthFt` number, double: The width of the surface type, in feet. - `lengthM` number, double: The length of the surface type, in meters. Applicable for runway and parking surface types. - `ldaM` number, double: The landing distance available for the runway, in meters. Applicable for runway surface types only. - `widthM` number, double: The width of the surface type, in meters. - `startLat` number, double: WGS-84 latitude of the coordinate representing the start-point of a surface, in degrees. -90 to 90 degrees (negative values south of equator). - `startLon` number, double: WGS-84 longitude of the coordinate representing the start-point of a surface, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `endLat` number, double: WGS-84 latitude of the coordinate representing the end-point of a surface, in degrees. -90 to 90 degrees (negative values south of equator). - `endLon` number, double: WGS-84 longitude of the coordinate representing the end-point of a surface, in degrees. -180 to 180 degrees (negative values west of Prime Meridian). - `pointReference` string: Description of the surface and its dimensions or how it is measured or oriented. - `material` string: The surface material (e.g. Asphalt, Concrete, Dirt). - `condition` string: The surface condition (e.g. GOOD, FAIR, POOR, SERIOUS, FAILED, CLOSED, UNKNOWN). - `rawWBC` string: Raw weight bearing capacity value or pavement strength. - `pcn` string: Pavement classification number (PCN) and tire pressure code. - `lcn` integer: Load classification number or pavement rating which ranks aircraft on a scale of 1 to 120. - `sWtKip` number, double: The max weight allowable on this surface type for an S-type (single) landing gear configuration, in kilopounds (kip). Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `sWtKipMod` number, double: The modified max weight allowable on this surface type for an S-type (single) landing gear configuration, in kilopounds (kip). - `sWtKipModNote` string: User input rationale for the manual modification of the prescribed value indicating the max weight allowable on this surface for an S-type (single) landing gear configuration. For more information, contact the provider source. - `tWtKip` number, double: The max weight allowable on this surface type for a T-type (twin (dual)) landing gear configuration, in kilopounds (kip).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `tWtKipMod` number, double: The modified max weight allowable on this surface type for a T-type (twin (dual)) landing gear configuration, in kilopounds (kip). - `tWtKipModNote` string: User input rationale for the manual modification of the prescribed value indicating the max weight allowable on this surface for a T-type (twin(dual)) landing gear configuration. For more information, contact the provider source. - `stWtKip` number, double: The max weight allowable on this surface type for an ST-type (single tandem) landing gear configuration, in kilopounds (kip).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `stWtKipMod` number, double: The modified max weight allowable on this surface type for an ST-type (single tandem) landing gear configuration, in kilopounds (kip). - `stWtKipModNote` string: User input rationale for the manual modification of the prescribed value indicating the max weight allowable on this surface for an ST-type (single tandem) landing gear configuration. For more information, contact the provider source. - `ttWtKip` number, double: The max weight allowable on this surface type for a GDSS TT-type (twin tandem) landing gear configuration, in kilopounds (kip).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `ttWtKipMod` number, double: The modified max weight allowable on this surface type for a GDSS TT-type (twin tandem) landing gear configuration, in kilopounds (kip). - `ttWtKipModNote` string: User input rationale for the manual modification of the prescribed value indicating the max weight allowable on this surface for a GDSS TT-type (twin tandem) landing gear configuration. For more information, contact the provider source. - `ddWtKip` number, double: The max weight allowable on this surface type for an FAA 2D-type (twin tandem) landing gear configuration, in kilopounds (kip).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `ddWtKipMod` number, double: The modified max weight allowable on this surface type for an FAA 2D-type (twin tandem) landing gear configuration, in kilopounds (kip). - `ddWtKipModNote` string: User input rationale for the manual modification of the prescribed value indicating the max weight allowable on this surface for an FAA 2D-type (twin tandem) landing gear configuration. For more information, contact the provider source. - `sbttWtKip` number, double: The max weight allowable on this surface type for an SBTT-type (single belly twin tandem) landing gear configuration, in kilopounds (kip).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `sbttWtKipMod` number, double: The modified max weight allowable on this surface type for an SBTT-type (single belly twin tandem) landing gear configuration, in kilopounds (kip). - `sbttWtKipModNote` string: User input rationale for the manual modification of the prescribed value indicating the max weight allowable on this surface for an SBTT-type (single belly twin tandem) landing gear configuration. For more information, contact the provider source. - `tdtWtkip` number, double: The max weight allowable on this surface type for a TDT-type (twin delta tandem) landing gear configuration, in kilopounds (kip).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `tdtWtKipMod` number, double: The modified max weight allowable on this surface type for a TDT-type (twin delta tandem) landing gear configuration, in kilopounds (kip). - `tdtWtKipModNote` string: User input rationale for the manual modification of the prescribed value indicating the max weight allowable on this surface for a TDT-type (twin delta tandem) landing gear configuration. For more information, contact the provider source. - `trtWtKip` number, double: The max weight allowable on this surface type for a TRT-type (triple tandem) landing gear configuration, in kilopounds (kip).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `trtWtKipMod` number, double: The modified max weight allowable on this surface type for a TRT-type (triple tandem) landing gear configuration, in kilopounds (kip). - `trtWtKipModNote` string: User input rationale for the manual modification of the prescribed value indicating the max weight allowable on this surface for a TRT-type (triple tandem) landing gear configuration. For more information, contact the provider source. - `ddtWtKip` number, double: The max weight allowable on this surface type for a DDT-type (double dual tandem) landing gear configuration, in kilopounds (kip).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `ddtWtKipMod` number, double: The modified max weight allowable on this surface type for a DDT-type (double dual tandem) landing gear configuration, in kilopounds (kip). - `ddtWtKipModNote` string: User input rationale for the manual modification of the prescribed value indicating the max weight allowable on this surface for a DDT-type (double dual tandem) landing gear configuration. For more information, contact the provider source. - `sWtKN` number, double: The max weight allowable on this surface type for an S-type (single) landing gear configuration, in kilonewtons (kN).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `tWtKN` number, double: The max weight allowable on this surface type for a T-type (twin (dual)) landing gear configuration, in kilonewtons (kN).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `stWtKN` number, double: The max weight allowable on this surface type for an ST-type (single tandem) landing gear configuration, in kilonewtons (kN).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `ttWtKN` number, double: The max weight allowable on this surface type for a GDSS TT-type (twin tandem) landing gear configuration, in kilonewtons (kN).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `ddWtKN` number, double: The max weight allowable on this surface type for an FAA 2D-type (twin tandem) landing gear configuration, in kilonewtons (kN).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `sbttWtKN` number, double: The max weight allowable on this surface type for an SBTT-type (single belly twin tandem) landing gear configuration, in kilonewtons (kN).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `tdtWtKN` number, double: The max weight allowable on this surface type for a TDT-type (twin delta tandem) landing gear configuration, in kilonewtons (kN).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `trtWtKN` number, double: The max weight allowable on this surface type for a TRT-type (triple tandem) landing gear configuration, in kilonewtons (kN).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `ddtWtKN` number, double: The max weight allowable on this surface type for a DDT-type (double dual tandem) landing gear configuration, in kilonewtons (kN).Note: The corresponding equivalent field is not converted by the UDL and may or may not be supplied by the provider. The provider/consumer is responsible for all unit conversions. - `lighting` boolean: Flag indicating the surface has lighting. - `lightsUNKN` boolean: Flag indicating the runway lighting is unknown. Applicable for runway surface types only. - `lightsAPRCH` boolean: Flag indicating the runway has approach lights. Applicable for runway surface types only. - `lightsRWY` boolean: Flag indicating the runway has edge lighting. Applicable for runway surface types only. - `lightsSEQFL` boolean: Flag indicating the runway has Sequential Flashing (SEQFL) lights. Applicable for runway surface types only. - `lightsVASI` boolean: Flag indicating the runway has Visual Approach Slope Indicator (VASI) lights. Applicable for runway surface types only. - `lightsPAPI` boolean: Flag indicating the runway has Precision Approach Path Indicator (PAPI) lights. Applicable for runway surface types only. - `lightsOLS` boolean: Flag indicating the runway has Optical Landing System (OLS) lights. Applicable for runway surface types only. - `lightsREIL` boolean: Flag indicating the runway has Runway End Identifier Lights (REIL). Applicable for runway surface types only. - `lightsTDZL` boolean: Flag indicating the runway has Touchdown Zone lights. Applicable for runway surface types only. - `lightsCL` boolean: Flag indicating the runway has centerline lights. Applicable for runway surface types only. - `obstacle` boolean: Flag indicating that one or more obstacles or obstructions exist in the proximity of this surface. - `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. - `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' | 'EXERCISE' | 'SIMULATED', 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 - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `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`: 7 info - api operation id `create_126` removed and replaced with `` - the endpoint scheme security `BasicAuth` was removed from the API - added the new optional request property `endLat` - added the new optional request property `endLon` - …3 more [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/surface/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)