> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Person Assets

> Find US aircraft linked to a person through public registry records.

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

**name** `string` *required*

Name. 2 to 200 characters.

**purpose** `string` *required*

Purpose. 10 to 500 characters.

**company** `string`

Company. 2 to 200 characters.

**city** `string`

City. 2 to 100 characters.

**country** `string`

Country. 2 to 100 characters.

**birth\_year\_range** `string`

Inclusive YYYY-YYYY range; public sources in this version cannot verify it.

<Snippet file="audit-context-params.mdx" />

<Snippet file="cached-record-params.mdx" />

## Response (200 OK)

Top-level envelope: `success` (boolean) and `data` (object). All fields below are nested under `data`.

**data.request\_id** `string`

Durable job ID for audit and lookup

**data.status** `string`

Job status: `completed`

**data.tool** `string`

Always `person_assets`

**data.result** `object`

The answer, described under Result below

**data.evidence** `object`

Where the answer came from and when

**data.cached** `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

**data.fetched\_at** `string`

When the record was obtained from its source, as an ISO 8601 UTC time; equals `evidence.retrieved_at`

**data.evidence.source** `string`

The public body the data comes from. Always `US Securities and Exchange Commission; US Federal Aviation Administration`.

**data.evidence.source\_kind** `string`

`public` when the data comes from a public body, `commercial` otherwise

**data.evidence.retrieved\_at** `string`

When the lookup was made, as an ISO 8601 UTC time

**data.evidence.as\_of** `string | null`

When the source says the fact was last updated, or `null` when the source gives no date

## Result

Nested under `data.result`.

**data.result.person** `object | null`

Person. `null` when the source gives no value.

**data.result.person.name** `string`

Name.

**data.result.person.matched\_on** `string[]`

Matched on.

**data.result.candidates** `object[]`

Candidates.

**data.result.candidates\[].name** `string`

Name.

**data.result.candidates\[].cik** `string | null`

Cik. `null` when the source gives no value.

**data.result.candidates\[].companies** `string[]`

Companies.

**data.result.candidates\[].roles** `string[]`

Roles.

**data.result.candidates\[].city** `string | null`

City. `null` when the source gives no value.

**data.result.companies** `object[]`

Companies.

**data.result.companies\[].name** `string`

Name.

**data.result.companies\[].role** `string`

Role.

**data.result.companies\[].since** `string | null`

Since. `null` when the source gives no value.

**data.result.companies\[].until** `string | null`

Until. `null` when the source gives no value.

**data.result.companies\[].source** `object`

Source.

**data.result.companies\[].source.source** `string`

Source.

**data.result.companies\[].source.as\_of** `string | null`

As of. `null` when the source gives no value.

**data.result.companies\[].source.record\_id** `string`

Record id.

**data.result.companies\[].source.name** `string`

Name.

**data.result.companies\[].source.company** `string | null`

Company. `null` when the source gives no value.

**data.result.companies\[].source.role** `string | null`

Role. `null` when the source gives no value.

**data.result.companies\[].source.city** `string | null`

City. `null` when the source gives no value.

**data.result.companies\[].source.country** `string | null`

Country. `null` when the source gives no value.

**data.result.assets** `object[]`

Assets.

**data.result.assets\[].kind** `string`

Kind.

**data.result.assets\[].identifier** `string`

Identifier.

**data.result.assets\[].icao24** `string | null`

Icao24. `null` when the source gives no value.

**data.result.assets\[].description** `string | null`

Description. `null` when the source gives no value.

**data.result.assets\[].derived** `object`

Derived.

**data.result.assets\[].derived.link** `object`

Link.

**data.result.assets\[].derived.link.rule** `string`

Rule.

**data.result.assets\[].derived.link.from** `object[]`

From.

**data.result.assets\[].derived.link.from\[].source** `string`

Source.

**data.result.assets\[].derived.link.from\[].as\_of** `string | null`

As of. `null` when the source gives no value.

**data.result.assets\[].derived.link.from\[].record\_id** `string`

Record id.

**data.result.assets\[].derived.link.from\[].name** `string`

Name.

**data.result.assets\[].derived.link.from\[].company** `string | null`

Company. `null` when the source gives no value.

**data.result.assets\[].derived.link.from\[].role** `string | null`

Role. `null` when the source gives no value.

**data.result.assets\[].derived.link.from\[].city** `string | null`

City. `null` when the source gives no value.

**data.result.assets\[].derived.link.from\[].country** `string | null`

Country. `null` when the source gives no value.

**data.result.assets\[].derived.link.confidence** `string`

Confidence.

**data.result.coverage** `object`

Coverage.

**data.result.coverage.sec** `object`

Sec.

**data.result.coverage.sec.available** `boolean`

Available.

**data.result.coverage.sec.as\_of** `string | null`

As of. `null` when the source gives no value.

**data.result.coverage.sec.scope** `string`

Scope.

**data.result.coverage.sec.reason** `string | null`

Reason. `null` when the source gives no value.

**data.result.coverage.faa** `object`

Faa.

**data.result.coverage.faa.available** `boolean`

Available.

**data.result.coverage.faa.as\_of** `string | null`

As of. `null` when the source gives no value.

**data.result.coverage.faa.scope** `string`

Scope.

**data.result.coverage.faa.reason** `string | null`

Reason. `null` when the source gives no value.

**data.result.coverage.aircraft\_opt\_outs** `object`

Aircraft opt outs.

**data.result.coverage.aircraft\_opt\_outs.available** `boolean`

Available.

**data.result.coverage.aircraft\_opt\_outs.as\_of** `string | null`

As of. `null` when the source gives no value.

**data.result.coverage.aircraft\_opt\_outs.scope** `string`

Scope.

**data.result.coverage.aircraft\_opt\_outs.reason** `string | null`

Reason. `null` when the source gives no value.

**data.result.coverage.limitations** `string[]`

Limitations.

**data.result.coverage.truncated** `boolean`

Truncated.

```bash cURL theme={null}
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/person-assets \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "name": "Example Person",
    "company": "Example Company",
    "purpose": "Research public registry connections for due diligence."
  }'
```

```javascript JavaScript theme={null}
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/person-assets", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "name": "Example Person",
    "company": "Example Company",
    "purpose": "Research public registry connections for due diligence."
  }),
});
```

```typescript SDK theme={null}
const result = await agent.tool('lookup/person-assets', {
  name: 'Example Person',
  company: 'Example Company',
  purpose: 'Research public registry connections for due diligence.'
});
console.log(result.result);
console.log(result.evidence);
```

```json Response (200) theme={null}
{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "person_assets",
    "result": {
      "person": null,
      "candidates": [],
      "companies": [],
      "assets": [],
      "coverage": {
        "sec": {
          "available": false,
          "as_of": null,
          "scope": "Published SEC reporting-owner roles",
          "reason": "Dataset unavailable"
        },
        "faa": {
          "available": false,
          "as_of": null,
          "scope": "US FAA civil aircraft registry",
          "reason": "Dataset unavailable"
        },
        "aircraft_opt_outs": {
          "available": false,
          "as_of": null,
          "scope": "Authoritative aircraft opt-out list",
          "reason": "Authoritative list unavailable"
        },
        "limitations": [
          "Vessels and private-company registries are not covered."
        ],
        "truncated": false
      }
    },
    "evidence": {
      "source": "US Securities and Exchange Commission; US Federal Aviation Administration",
      "source_kind": "public",
      "retrieved_at": "2026-11-07T00:00:00.000Z",
      "calls": [
        {
          "retrieved_at": "2026-11-07T00:00:00.000Z"
        }
      ],
      "as_of": null
    }
  }
}
```

> [!NOTE]
>
> See [Pricing](https://docs.oneshotagent.com/pricing.md) 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}`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.