aircraft search derived

{
  "input": {
    "type": "http",
    "method": "GET",
    "pathParams": {
      "query": ":query"
    },
    "queryParams": {
      "format": "json"
    }
  },
  "output": {
    "type": "json",
    "example": {
      "result": "MATCHES_FOUND",
      "matches": [
        {
          "model": "172K",
          "title": "N17973 - CESSNA 172K - SALE REPORTED",
          "source": "FAA",
          "location": "MARION, TX",
          "record_id": 12345,
          "tail_number": "N17973",
          "manufacturer": "CESSNA",
          "aircraft_type": "Fixed wing single engine",
          "year_manufactured": "1972",
          "airworthiness_certification": "Standard"
        }
      ],
      "coverage": {
        "_about": "Measured per call against the upstream FAA MASTER.txt row count, and stamped with when it was measured. When complete is false the result code is NO_MATCH_INCOMPLETE_CORPUS, never NO_MATCH, so an empty answer is never mistaken for proof that an aircraft is unregistered. Numbers shown are illustrative of the SHAPE; this route reports its real coverage on every call, including when that coverage is partial.",
        "complete": false,
        "states_held": 57,
        "records_held": 63152,
        "upstream_states": 59,
        "completeness_pct": 20,
        "upstream_records": 315211,
        "coverage_measured_utc": "2026-08-04T03:50:00Z"
      },
      "match_count": 1,
      "search_evidence": {
        "scan": {
          "matches_omitted": 25,
          "candidates_examined": 35,
          "candidate_set_complete": true
        },
        "_about": "Proof of work, on EVERY result including NO_MATCH: the terms actually searched, how many records were in scope per source, how fresh they are, whether the scan completed or was truncated, and on an empty result the per-term record counts plus a known-good control query re-measured live in the same request. Numbers shown are illustrative.",
        "corpus": {
          "records_in_scope": 1558599,
          "newest_record_ingested_utc": "2026-08-01T15:47:55Z"
        },
        "result_confidence": "matches_found"
      }
    }
  }
}