Obstacles
GET/api/v1/obstacles/{oasNumber}Private Pilot

Get By Oas Number

Gets a single obstacle by its OAS (Obstacle Assessment Surface) number.

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/obstacles/12-345678"

Description

GET /api/v1/obstacles/12-345678

Parameters

NameInTypeDescription
oasNumber*pathstringObstacle Assessment Surface number (e.g., 12-345678)

Response Schema

200Returns the obstacleObstacleDto
oasNumberstring

Obstacle Assessment Surface (OAS) number — the unique identifier for this obstacle. This is the key used to look up obstacles returned by the navigation log endpoint's ObstacleOasNumbers field.

stateIdstringnullable

Two-letter state identifier.

cityNamestringnullable

City nearest to the obstacle.

latitudenumbernullable

Latitude in decimal degrees (WGS 84).

longitudenumbernullable

Longitude in decimal degrees (WGS 84).

obstacleTypestringnullable

Type of obstacle (e.g., TOWER, BLDG, STACK).

quantityintegernullable

Number of obstacles at this location.

heightAglintegernullable

Height above ground level in feet.

heightAmslintegernullable

Height above mean sea level in feet.

lightingObstacleLightingnullable

Lighting type on the obstacle.

horizontalAccuracyHorizontalAccuracynullable

Horizontal accuracy of the position data.

verticalAccuracyVerticalAccuracynullable

Vertical accuracy of the height data.

markingObstacleMarkingnullable

Marking type on the obstacle.

verificationStatusVerificationStatusnullable

Verification status of the obstacle data.

404If the obstacle is not foundApiErrorResponse
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.

Search Documentation

Search docs, endpoints, and schemas