Runways
GET
/api/v1/runways/nearbyStudent PilotSearch Nearby
Searches for runways near a geographic point using the parent airport's location. Useful for finding diversion airports with suitable runways.
Code Examples
curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/runways/nearby?lat=40.6413&lon=-73.7781&limit=25&radiusNm=10&minLength=25&surfaceType=value&includeGeometry=true"curl \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://api.preflightapi.io/api/v1/runways/nearby?lat=40.6413&lon=-73.7781&limit=25&radiusNm=10&minLength=25&surfaceType=value&includeGeometry=true"Description
GET /api/v1/runways/nearby?lat=32.897&lon=-97.038 — default 30 NM radius
GET /api/v1/runways/nearby?lat=32.897&lon=-97.038&minLength=4000&surfaceType=Asphalt — paved 4000+ ft runways
GET /api/v1/runways/nearby?lat=32.897&lon=-97.038&includeGeometry=true — with polygon geometryReturns paginated results of RunwayDto
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| lat | query | number | Latitude in decimal degrees (-90 to 90) |
| lon | query | number | Longitude in decimal degrees (-180 to 180) |
| cursor | query | string? | Opaque cursor value from a previous response's pagination.nextCursor field. Omit or leave null to start from the first page. |
| limit | query | integer | Maximum number of items to return per page. Minimum 1, maximum 500, default 100. |
| radiusNm | query | number | Search radius in nautical miles (default 30, max 500) |
| minLength | query | integer? | Minimum runway length in feet |
| surfaceType | query | RunwaySurfaceType? | Filter by runway surface type enum (e.g., Asphalt, Concrete). Matches runways where the type appears as either the primary or secondary surface. ConcreteAsphaltSnowIceMatsTreatedGravelTurfDirtPartiallyPavedRooftopWaterAluminumBrickCalicheCoralDeckGrassMetalNonStandardOilChipPspSandSodSteelWoodPorousFrictionCourse |
| includeGeometry | query | boolean | Include ArcGIS runway polygon geometry in the response (default false) |
Response Schema
codestring
Machine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestring
Human-readable error message suitable for display.
detailsstringnullable
Additional error details (only included in development environment).
servicestringnullable
Name of the external service that failed (only included for 503 errors).
validationErrorsRecord<string, string[]>nullable
Field-level validation errors (only for validation failures).
timestampstring
UTC timestamp when the error occurred.
traceIdstringnullable
Correlation ID for tracing the request.
pathstringnullable
Request path that generated the error.