{
  "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": "11I1qMgu5XObrv5fu"
  },
  "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": "Tail number (N-Number)",
            "type": "string",
            "description": "US aircraft registration, for example N172SP. Returns owner, make, model, engine, seats, Mode S hex, status and linked NTSB incidents."
          },
          "nNumbers": {
            "title": "More tail numbers (optional)",
            "type": "array",
            "description": "Extra N-Numbers for the same run, one per line, for example N747BA. Registered, deregistered and reserved numbers are all found.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeIncidents": {
            "title": "Add NTSB accident and incident records",
            "type": "boolean",
            "description": "One extra row per linked incident, each billed as an incident record. Turn off for aircraft rows only.",
            "default": true
          },
          "searchIn": {
            "title": "Search in",
            "enum": [
              "registered",
              "deregistered",
              "reserved"
            ],
            "type": "string",
            "description": "Registered aircraft, deregistered (cancelled) aircraft, or reserved N-Numbers.",
            "default": "registered"
          },
          "state": {
            "title": "Owner 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": "US state or territory of the owner. For reserved N-Numbers, the state of whoever reserved it.",
            "default": ""
          },
          "ownerName": {
            "title": "Owner name contains",
            "type": "string",
            "description": "Text in the owner or co-owner name, for example Delta Air Lines or Smith. Not case sensitive.",
            "default": ""
          },
          "manufacturer": {
            "title": "Manufacturer contains",
            "type": "string",
            "description": "For example Cessna, Piper, Boeing or Robinson. Not case sensitive.",
            "default": ""
          },
          "model": {
            "title": "Model contains",
            "type": "string",
            "description": "For example 172, PA-28 or 737. Not case sensitive.",
            "default": ""
          },
          "yearFrom": {
            "title": "Year built from",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Example: 1990. Empty = no lower limit."
          },
          "yearTo": {
            "title": "Year built to",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Example: 2020. Empty = no upper limit."
          },
          "status": {
            "title": "Registration status",
            "enum": [
              "any",
              "valid",
              "unregistered",
              "questionable"
            ],
            "type": "string",
            "description": "Registered aircraft only. Valid = current registrations. Unregistered = assigned numbers with no owner (do not combine with State or Owner). Questionable = expired, revoked, pending, cancelled and others.",
            "default": "any"
          },
          "lastName": {
            "title": "Pilot last name",
            "type": "string",
            "description": "For example Armstrong. Add a first name for common surnames: a last-name-only search matching over 50 pilots returns no rows."
          },
          "firstName": {
            "title": "Pilot first name",
            "type": "string",
            "description": "For example Neil."
          },
          "maxItems": {
            "title": "Max rows (free plan: 10)",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stops after this many rows. Free plan: 10 per run. Paid: up to 1,000,000.",
            "default": 10
          },
          "onlyNew": {
            "title": "Only new records",
            "type": "boolean",
            "description": "Returns only records not delivered by an earlier run with the same inputs, and charges only for those. The first run delivers everything.",
            "default": false
          },
          "stateKey": {
            "title": "Monitor name (optional)",
            "type": "string",
            "description": "Only needed to keep two watch lists apart for identical inputs. Example: texas-cessna.",
            "default": ""
          },
          "resetSeen": {
            "title": "Forget seen records first",
            "type": "boolean",
            "description": "Clears this watch list before the run, so everything is delivered 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}