# Search the FAA aircraft registry: `POST /v1/aircraft/search`

Cost: 2 credits (2 a page (a page with no records and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/aircraft-search

Search every US-registered aircraft (or the deregistered, reserved,
dealer, document-index, aircraft-model or engine-model tables) by
N-number, owner name, manufacturer, model, state, city, ZIP, year, type,
seats, horsepower, status and dates. Up to 100 records a page, with the
total. 2 credits a page; a page with no records is free.

From the FAA's daily releasable database: as fresh as the FAA's last
working-day file (``data_as_of``). Owners the FAA withholds are blank.
For one aircraft's live record use ``/v1/aircraft/registration``.

Request body (JSON):

- `dataset` (string; optional; default registered; one of registered, deregistered, reserved, dealers, documents, models, engines): registered (current registrations), deregistered, reserved (N-numbers), dealers, documents (FAA document index), models (aircraft model reference) or engines (engine model reference).
- `n_number` (string | null; optional; max length 8): Tail number, e.g. N172SP (the N is optional).
- `serial_number` (string | null; optional; max length 40): Manufacturer serial number, exact.
- `mode_s_hex` (string | null; optional; max length 10): Mode S code, hex (ICAO 24-bit address).
- `name` (string | null; optional; max length 100): Owner, registrant, dealer or document party: names starting with this. Individuals are LAST FIRST.
- `manufacturer` (string | null; optional; max length 80): Aircraft manufacturer, starting with this.
- `model` (string | null; optional; max length 80): Aircraft model, starting with this.
- `mfr_mdl_code` (string | null; optional; max length 10): FAA aircraft model code.
- `engine_manufacturer` (string | null; optional; max length 80): Engine manufacturer, starting with this.
- `eng_mfr_mdl` (string | null; optional; max length 10): FAA engine model code (engines dataset).
- `state` (string | null; optional; min length 2, max length 2): Two-letter state.
- `city` (string | null; optional; max length 40): Owner's or dealer's city, exact (e.g. AUSTIN).
- `zip` (string | null; optional; pattern ^\d{5}$): Five-digit ZIP code.
- `country` (string | null; optional; max length 4): FAA country code, e.g. US.
- `export_country` (string | null; optional; max length 4): Deregistered: country exported to.
- `type_aircraft` (string | null; optional; one of Glider, Balloon, Blimp/Dirigible, Fixed Wing Single-Engine, Fixed Wing Multi-Engine, Rotorcraft, Weight-Shift-Control, Powered Parachute, Gyroplane, Hybrid Lift, Other): Aircraft type, as the FAA labels it.
- `type_engine` (string | null; optional; one of None, Reciprocating, Turbo-prop, Turbo-shaft, Turbo-jet, Turbo-fan, Ramjet, 2 Cycle, 4 Cycle, Unknown, Electric, Rotary): Engine type, as the FAA labels it.
- `type_registrant` (string | null; optional; one of Individual, Partnership, Corporation, Co-Owned, Government, LLC, Non-Citizen Corporation, Non-Citizen Co-Owned): Who the aircraft is registered to.
- `status_code` (string | null; optional; max length 3): FAA status code, e.g. V (valid).
- `reservation_type` (string | null; optional; max length 3): Reserved: FAA reservation type, e.g. AA.
- `certificate_number` (string | null; optional; max length 12): Dealers: certificate number.
- `expired` (boolean | null; optional): Dealers: only expired (true) or current (false).
- `collateral` (string | null; optional; max length 60): Documents: collateral as the FAA writes it.
- `document_type` (string | null; optional; max length 4): Documents: BOS, S/A, REL, ...
- `document_id` (string | null; optional; max length 20): Documents: FAA document id, exact.
- `year_from` (integer | null; optional; min 1900, max 2100): Year manufactured, from.
- `year_to` (integer | null; optional; min 1900, max 2100): Year manufactured, up to.
- `seats_from` (integer | null; optional; min 0, max 1000): Seats, from.
- `seats_to` (integer | null; optional; min 0, max 1000): Seats, up to.
- `engines_from` (integer | null; optional; min 0, max 20): Number of engines, from.
- `engines_to` (integer | null; optional; min 0, max 20): Number of engines, up to.
- `horsepower_from` (integer | null; optional; min 0, max 100000): Engine horsepower, from.
- `horsepower_to` (integer | null; optional; min 0, max 100000): Engine horsepower, up to.
- `thrust_from` (integer | null; optional; min 0, max 1000000): Engine thrust in pounds, from.
- `thrust_to` (integer | null; optional; min 0, max 1000000): Engine thrust in pounds, up to.
- `expiration_from` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): YYYY-MM-DD
- `expiration_to` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Registration expiration date, up to (YYYY-MM-DD).
- `certificate_issue_from` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Certificate issue date, from (YYYY-MM-DD).
- `certificate_issue_to` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Certificate issue date, up to (YYYY-MM-DD).
- `cancel_from` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Deregistered: cancel date, from.
- `cancel_to` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Deregistered: cancel date, up to (YYYY-MM-DD).
- `reserved_from` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Reserved: date reserved, from (YYYY-MM-DD).
- `reserved_to` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Reserved: date reserved, up to (YYYY-MM-DD).
- `received_from` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Documents: received date, from.
- `received_to` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Documents: received date, up to (YYYY-MM-DD).
- `limit` (integer; optional; default 50; min 1, max 100): Records per page (up to 100).
- `page` (integer; optional; default 1; min 1, max 10000): Page number, from 1.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
