--- title: "GET /udl/surface/{id}" method: GET path: "/udl/surface/{id}" tags: ["Site"] --- # GET /udl/surface/{id} `GET /udl/surface/{id}` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/surface/{id}` - Auth: none declared Service operation to get a single Surface record by its unique ID passed as a path parameter. ## Path parameters - `id` string, required ## Query parameters - `firstResult` integer - `maxResults` integer ## Response `200` OK - SurfaceFull: 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. - `surfaceObstructions` SurfaceObstructionFull[]: An array of SurfaceNavigation objects representing information about obstructions proximal to this surface. This is a read-only field that will be populated with any associated SurfaceObstruction objects for queries that return the full schema. - `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. - `idSurface` string, required: The unique identifier of the associated surface record. This field is required when posting, updating, or deleting a SurfaceObstruction record. - `idNavigationalObstruction` string: The unique identifier of the associated NavigationalObstruction record. - `obstructionSideCode` string: A code that indicates which side of the surface end is affected by this obstruction. - `obstructionDesc` string: Description of this surface obstruction. - `obstructionHeight` number, double: The height above ground level of the surface obstruction, in feet. - `distanceFromEdge` number, double: The distance from the surface edge to this obstruction, in feet. - `distanceFromCenterLine` number, double: The distance from the surface center line to this obstruction, in feet. - `distanceFromThreshold` number, double: The distance from the surface threshold to this obstruction, in feet. - `advisoryRequired` string[]: Array of all vehicles that are affected by this obstruction at the surface end-point, and require an advisory for usage. - `approvalRequired` string[]: Array of all vehicles that are affected by this obstruction at the surface end-point, and require an approval for usage. - `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. - `source` string, required: Source of the data. - `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. - `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. - `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 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. - `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. ## Other responses - `400`: Bad Request - `401`: Invalid/Missing User Credentials - `403`: User Is Not Authorized - `404`: Item Not Found - `405`: Method Not Allowed - `406`: MediaType Not Accepted by Request Headers - `429`: Rate of Requests Exceeds Allowed Limit - `500`: Internal Server Error ## Changes > 12 revisions in range; 1 could not be searched. - **2025-05-29** `4e1cbc17e814`: 2 info - added the new optional `query` request parameter `firstResult` - added the new optional `query` request parameter `maxResults` - **2025-04-16** `75f764c843a9`: 8 info - api operation id `find_127` removed and replaced with `` - the endpoint scheme security `BasicAuth` was removed from the API - added the optional property `endLat` to the response with the `200` status - added the optional property `endLon` to the response with the `200` status - …4 more [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/surface/:id/get.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)