API URL
POST /api/v1/aircraft/lookup
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
tail
required
string
FAA tail number query parameter
hex
required
string
ICAO hex path parameter
code
required
string
Aircraft type path parameter
Example Request
Code
GET https://datpaq.com/api/v1/aircraft/lookup?api_key=your-api-key&tail=N12345Successful Response
Status
HTML
200 OKBody
Code
{
"tail": "N12345",
"valid": true,
"manufacturer": "Cessna",
"model": "172M",
"correlationId": "abc123"
}Field
Type
status
string
service
string
timestamp
string
version
string
tail
string
valid
boolean
owner
string
manufacturer
string
model
string
type
string
year
number
reason
string
error
string
hex
string
code
string
category
string
seating
number
success
boolean
message
string
data
object
correlationId
string
Error Response
Example
Code
401 AuthenticationError - Missing or invalid API key at gateway layer: Request rejected by authentication policy
404 RouteNotFound - Request path does not match mounted routes: Requested endpoint is unavailable
422 ValidationError - Missing tail query or invalid tail/ICAO format: Input validation failed
500 InternalError - Unhandled middleware or route-level failure: Service could not complete processing
501 NotImplemented - Batch route scaffold invoked: Feature exists but is not yet implementedLast Updated: May 4, 2026