Faa Airmen Search Instructors
faa_airmen_search_instructorsFind releasable flight and ground instructor certificate records by name, state, and rating codes. Supply at least one name, state, city, ZIP, or rating filter. City and ZIP filters require operator-enabled location access. While the operator's personal-data redaction is on (the default), lastName and firstName are both required, nameMatch prefix and city or ZIP filters are rejected, and city and ZIP are withheld. Legacy expiry fields do not establish instructor currency; CFI certificates no longer expire under the December 2024 rule.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "faa_airmen_search_instructors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Exact city, 1–60 visible characters; requires operator-enabled location access and is rejected while personal-data redaction is on. Blank means unset. | |
| limit | No | Maximum complete people or reference entries per page; default 10, maximum 50. A larger limit returns at most 50, with a notice. | |
| state | No | Two-letter USPS code: one of the 50 states, DC, PR, GU, VI, MP, AS, FM, MH, PW, or the military AA, AE, AP; trimmed and uppercased. Airmen with foreign addresses carry no state. Blank means unset. | |
| offset | No | Zero-based offset; default 0, maximum 10000. Follow nextOffset or narrow filters at the cap. | |
| zipCode | No | Five-digit ZIP or ZIP+4, preserving leading zeros; requires operator-enabled location access and is rejected while personal-data redaction is on. Blank means unset. | |
| lastName | No | LAST NAME, which may include a suffix; the default words match finds SMITH JR from SMITH. 1–60 visible characters after normalization. Blank means unset. | |
| firstName | No | FIRST NAME, which usually includes middle names; the default words match finds JOHN ROBERT from JOHN. 1–60 visible characters after normalization. Blank means unset. | |
| nameMatch | No | How each supplied name field matches; default words for name searches. words: the field equals the term or continues with a space after it; only a space separates words, so a hyphenated or apostrophe name is one word. exact: the whole field. prefix: the field begins with the term, also mid-word; rejected while personal-data redaction is on. | |
| ratingCodes | No | One to eleven codes, repeats collapsed; every code must occur on the same qualifying certificate, never across certificates. CFII is INSTA, INSTH, INSTI, or INSTP on a flight instructor (F) certificate; MEI is AME or ASME on F; INST, ADV, and BASIC occur only on ground instructor (G) certificates. | |
| instructorType | No | Select flight F, ground G, or both instructor certificate types; default both. | both |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| notice | No | Snapshot limitations, absence guidance, source-quality notices for the returned records, paging notices (a clamped limit, the offset cap, or a page the response size budget ended before limit), and operational notices; may be empty. | |
| hasMore | No | Whether another page is reachable within the offset cap. | |
| matches | No | Matching instructor candidates; certificate presence does not establish currency. | |
| nextOffset | No | Next reachable offset, or null when no next page is available. | |
| provenance | No | Snapshot provenance, or null for static reference topics. | |
| totalCount | No | Total matches after filtering, before paging. | |
| atPagingCap | No | Matches remain but the next offset exceeds 10000; narrow the filters. | |
| piiRedacted | No | Operator personal-data redaction: true withholds city, ZIP, and medical fields and limits searches to a full name or Unique ID. | |
| returnedCount | No | Complete people or reference entries returned on this page. Fewer than limit means the results ended or the response size budget ended the page; while hasMore is true, the notice names the offset to continue from. | |
| appliedFilters | No | Every effective normalized selector, filter, and paging value. |