Skip to main content
POST
Connect a person to US aircraft registration records directly or through reported SEC officer and director roles. A link means registry records connect the person to the aircraft. It does not establish outright ownership, use, location, or who is aboard. Ambiguous names and unverifiable disambiguators return candidates only. Results are private and require a permitted purpose.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
required
Name. 2 to 200 characters.
string
required
Purpose. 10 to 500 characters.
string
Company. 2 to 200 characters.
string
City. 2 to 100 characters.
string
Country. 2 to 100 characters.
string
Inclusive YYYY-YYYY range; public sources in this version cannot verify it.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status: completed
string
Always person_assets
object
The answer, described under Result below
object
Where the answer came from and when
boolean
true when the answer was served from OneShot’s store of earlier lookups (or its own copy of a public dataset), false when the source was asked for this call
string
When the record was obtained from its source, as an ISO 8601 UTC time; equals evidence.retrieved_at
string
The public body the data comes from. Always US Securities and Exchange Commission; US Federal Aviation Administration.
string
public when the data comes from a public body, commercial otherwise
string
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.
object | null
Person. null when the source gives no value.
string
Name.
string[]
Matched on.
object[]
Candidates.
string
Name.
string | null
Cik. null when the source gives no value.
string[]
Companies.
string[]
Roles.
string | null
City. null when the source gives no value.
object[]
Companies.
string
Name.
string
Role.
string | null
Since. null when the source gives no value.
string | null
Until. null when the source gives no value.
object
Source.
string
Source.
string | null
As of. null when the source gives no value.
string
Record id.
string
Name.
string | null
Company. null when the source gives no value.
string | null
Role. null when the source gives no value.
string | null
City. null when the source gives no value.
string | null
Country. null when the source gives no value.
object[]
Assets.
string
Kind.
string
Identifier.
string | null
Icao24. null when the source gives no value.
string | null
Description. null when the source gives no value.
object
Derived.
Link.
Rule.
From.
Source.
As of. null when the source gives no value.
Record id.
Name.
Company. null when the source gives no value.
Role. null when the source gives no value.
City. null when the source gives no value.
Country. null when the source gives no value.
Confidence.
object
Coverage.
object
Sec.
boolean
Available.
string | null
As of. null when the source gives no value.
string
Scope.
string | null
Reason. null when the source gives no value.
object
Faa.
boolean
Available.
string | null
As of. null when the source gives no value.
string
Scope.
string | null
Reason. null when the source gives no value.
object
Aircraft opt outs.
boolean
Available.
string | null
As of. null when the source gives no value.
string
Scope.
string | null
Reason. null when the source gives no value.
string[]
Limitations.
boolean
Truncated.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • SEC roles are reported as of a filing date, not proof of a current position or control. Employment dates are unknown.
  • Coverage states which published sources were usable. Missing or stale coverage is no evidence either way, not proof of no assets.
  • Vessels, private-company registries, proxy-only roles, trusts and foreign shell companies are not resolved.
  • Aircraft links require fresh authoritative opt-out coverage. Fixture-only or missing coverage withholds aircraft links.
  • Link rule, source rows, dates and confidence are derived evidence, not a statement of ownership. No street addresses are returned.
  • Birth years are not verified by these sources. Lists are bounded to 50 candidates, 50 role filings and 50 aircraft per owner search; at most 10 companies and 50 asset links per answer.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}