Faa Airmen Verify Certificate
faa_airmen_verify_certificateFind releasable FAA airman records by exact Unique ID or name and read their certificate records. Use name mode to discover IDs, then use an ID for ratings or informational medical fields. Certificate type, level, rating, and type-rating filters must all match one certificate, and each match still returns all its certificates. While the operator's personal-data redaction is on (the default), name mode needs lastName and firstName, nameMatch prefix and city or ZIP filters are rejected, and city and ZIP are withheld. A missing or matching record is not a current licensing or operating-privilege determination.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"mode": "<mode>"
},
"name": "faa_airmen_verify_certificate"
}
}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. | |
| mode | Yes | id requires uniqueId and forbids nonblank name/location fields and explicit nameMatch; name requires lastName, plus firstName while personal-data redaction is on, and forbids nonblank uniqueId. | |
| 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. | |
| uniqueId | No | Opaque FAA Unique ID from a faa_airmen_verify_certificate, faa_airmen_search_instructors, or faa_airmen_verify_remote_pilot result, A or C plus seven digits, for example A9999999; not a certificate number. Trimmed and uppercased. | |
| 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 rating codes, repeats collapsed; every code must occur on the same certificate as every other requested credential, 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. | |
| typeRatings | No | One to eleven type-rating designators, repeats collapsed; every designator must occur on the same certificate as every other requested credential. | |
| certificateType | No | One FAA certificate type letter, its description from faa_airmen_list_reference topic certificate_types (case-insensitive; underscore or space, such as remote pilot or flight_instructor), or CFI; selects people while retaining all their certificates. | |
| certificateLevel | No | One level letter listed for the certificateType in faa_airmen_list_reference topic certificate_levels, such as A (airline transport pilot) with certificateType P; requires certificateType and matches the certificate's own level. Trimmed and uppercased; blank means unset. |
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 | Separate identity candidates; never infer a single person from multiple matches. | |
| 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. |