Open Source Filings · Aircraft Search

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.osf-master-server.com/x402/aircraft/search/:query", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://api.osf-master-server.com/x402/aircraft/search/:query?format=json" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "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,
    "completeness_pct": 20,
    "coverage_measured_utc": "2026-08-04T03:50:00Z",
    "records_held": 63152,
    "states_held": 57,
    "upstream_records": 315211,
    "upstream_states": 59
  },
  "match_count": 1,
  "matches": [
    {
      "aircraft_type": "Fixed wing single engine",
      "airworthiness_certification": "Standard",
      "location": "MARION, TX",
      "manufacturer": "CESSNA",
      "model": "172K",
      "record_id": 12345,
      "source": "FAA",
      "tail_number": "N17973",
      "title": "N17973 - CESSNA 172K - SALE REPORTED",
      "year_manufactured": "1972"
    }
  ],
  "result": "MATCHES_FOUND",
  "search_evidence": {
    "_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": {
      "newest_record_ingested_utc": "2026-08-01T15:47:55Z",
      "records_in_scope": 1558599
    },
    "result_confidence": "matches_found",
    "scan": {
      "candidate_set_complete": true,
      "candidates_examined": 35,
      "matches_omitted": 25
    }
  }
}