{ "openapi": "3.0.1", "info": { "title": "FAA Aircraft Registry & Pilot Certification Lookup", "description": "Look up FAA aircraft registration by N-Number (owner, manufacturer, model, engine, status), FAA pilot certificates by name (type, ratings, limits) and NTSB accident or incident history for the same tail number. Export CSV, Excel, JSON. No login or API key. 3 record types in one dataset.", "version": "0.1", "x-build-id": "dpJDxUd34NeXdnFey" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/recordsdata~faa-aircraft-airmen-registry/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-recordsdata-faa-aircraft-airmen-registry", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/recordsdata~faa-aircraft-airmen-registry/runs": { "post": { "operationId": "runs-sync-recordsdata-faa-aircraft-airmen-registry", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/recordsdata~faa-aircraft-airmen-registry/run-sync": { "post": { "operationId": "run-sync-recordsdata-faa-aircraft-airmen-registry", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "nNumber": { "title": "N-Number", "type": "string", "description": "US aircraft registration number (tail number), e.g. \"N12345\". Returns the FAA registration record (owner, manufacturer, model, engine, seats, Mode S hex, status) plus any linked NTSB accident/incident records. Clear it to use the registry search below, or to look up a pilot only." }, "nNumbers": { "title": "More N-Numbers", "type": "array", "description": "A list of extra N-Numbers to look up in the same run, e.g. N172SP, N747BA. Registered, deregistered and reserved numbers are all found. Duplicates are removed.", "default": [], "items": { "type": "string" } }, "includeIncidents": { "title": "Include NTSB incidents", "type": "boolean", "description": "Add the linked NTSB accident and incident records for each N-Number looked up. Each incident row is billed as an incident record. Turn off to get aircraft rows only.", "default": true }, "searchIn": { "title": "Search in", "enum": [ "registered", "deregistered", "reserved" ], "type": "string", "description": "Which part of the FAA database to search: currently registered aircraft, deregistered (cancelled) aircraft, or reserved N-Numbers.", "default": "registered" }, "state": { "title": "State", "enum": [ "", "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "PR", "GU", "VI", "MP", "AS", "AA", "AE", "AP" ], "type": "string", "description": "Only aircraft whose owner is in this US state or territory (two-letter code). For reserved N-Numbers it is the state of the person who reserved it.", "default": "" }, "ownerName": { "title": "Owner name contains", "type": "string", "description": "Text that must appear in the registered owner name or in a co-owner name, e.g. \"Delta Air Lines\" or \"Smith\". Not case sensitive.", "default": "" }, "manufacturer": { "title": "Manufacturer contains", "type": "string", "description": "Aircraft manufacturer name, e.g. \"Cessna\", \"Piper\", \"Boeing\" or \"Robinson\". Not case sensitive. Not available for reserved N-Numbers.", "default": "" }, "model": { "title": "Model contains", "type": "string", "description": "Aircraft model, e.g. \"172\", \"PA-28\" or \"737\". Not case sensitive. Not available for reserved N-Numbers.", "default": "" }, "yearFrom": { "title": "Year built from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only aircraft built in this year or later, e.g. 1990. Leave empty for no lower limit." }, "yearTo": { "title": "Year built to", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only aircraft built in this year or earlier, e.g. 2020. Leave empty for no upper limit." }, "status": { "title": "Registration status", "enum": [ "any", "valid", "unregistered", "questionable" ], "type": "string", "description": "Registered aircraft only. \"Valid\" keeps current registrations. \"Unregistered\" keeps N-Numbers assigned to an aircraft that was never registered (these rows have no owner, so do not combine them with State or Owner name). \"Questionable\" keeps everything else: expired, revoked, pending, sold, cancelled or awaiting a renewal notice.", "default": "any" }, "lastName": { "title": "Last Name", "type": "string", "description": "Pilot's last name, e.g. \"Armstrong\". Combine with First Name to narrow a common surname (a last-name-only search that matches over 50 pilots returns no rows and asks for more criteria)." }, "firstName": { "title": "First Name", "type": "string", "description": "Pilot's first name, e.g. \"Neil\"." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of rows to return across all record types (aircraft, deregistered, reserved, pilot certificate, NTSB incident). Defaults to 10. Free users are limited to 10 items; paid users can raise it up to 1,000,000.", "default": 10 }, "onlyNew": { "title": "Only new records (monitoring)", "type": "boolean", "description": "Return only records not delivered by an earlier run with the same inputs, and charge only for those. Schedule the Actor daily to watch a state, a manufacturer or a list of N-Numbers for new registrations. The first run delivers everything and remembers it.", "default": false }, "stateKey": { "title": "Monitor name (optional)", "type": "string", "description": "Optional label for this watch list. Each distinct set of inputs already keeps its own list of seen records; add a label only to keep two lists apart for identical inputs.", "default": "" }, "resetSeen": { "title": "Reset seen records", "type": "boolean", "description": "Forget everything this watch list has already delivered before the run starts, so the next run delivers all records again.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }