# SEC EDGAR Schedule 13D/13G Beneficial Ownership Filings

> SEC EDGAR Schedule 13D/13G Beneficial Ownership Filings is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.02/call, status unknown (last checked 2026-10-11).

Returns parsed Schedule 13D and 13G beneficial ownership filings from SEC EDGAR for a US-listed company, including reporting persons, percent of class owned, voting/dispositive power, and activist intent.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/beneficial-ownership/{ticker}?utm_source=zero.xyz
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-sec-edgar-schedule-13d-13g-beneficial-ownership-ef828dfb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WlRzLFZYKMMXUSHS2zrKf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-x402stock-xyz-sec-edgar-schedule-13d-13g-beneficial-ownership-ef828dfb
```

Example prompt: Pull the latest Schedule 13D and 13G beneficial ownership filings for NVDA from SEC EDGAR — give me the top 5, including who filed, what percent of the class they own, and any activist intent stated.

## When to prefer this

Use this endpoint when you need structured, parsed beneficial ownership data directly from SEC EDGAR for any US-listed company. Prefer it over general SEC full-text search when you specifically need 13D/13G data with per-person voting/dispositive breakdowns and activist intent. It is especially useful for activist investing research, M&A signal detection, large shareholder monitoring, and regulatory compliance checks. It covers both passive (13G) and activist (13D) filings and supports filtering by type.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty result
- Ticker with no 13D/13G filings returns an empty filings array
- Unstructured filings (structured: false) may lack parsed reporting-person fields
- Derivative-based holdings may show percent_of_class below 5% despite triggering the threshold
- limit parameter above 25 is rejected
- Newly filed documents may have a short lag before appearing in EDGAR index

## How this service works

Schedule 13D/13G beneficial-ownership & activist stakes filed on a company (5%+ trigger)

## Output

A JSON object containing the company name, CIK, and an array of parsed Schedule 13D/13G filings. Each filing includes the schedule type, form, filing and event dates, CUSIP, security class, accession number, URL to the EDGAR filing, whether it is an amendment, and an array of reporting persons with their percent of class owned, aggregate shares, sole/shared voting power, sole/shared dispositive power, citizenship, and entity type. For 13D filings, the activist purpose/intent field is also included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "type": {
   "enum": [
    "13D",
    "13G",
    "all"
   ],
   "type": "string",
   "default": "all"
  },
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 25,
   "exclusiveMinimum": 0
  },
  "ticker": {
   "type": "string",
   "description": "US-listed ticker symbol (uppercase), e.g. AAPL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker",
  "data",
  "source",
  "as_of"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "cik",
    "company",
    "filings_parsed",
    "count",
    "filings"
   ],
   "properties": {
    "cik": {
     "type": "string"
    },
    "count": {
     "type": "number"
    },
    "company": {
     "type": "string"
    },
    "filings": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "schedule",
       "form",
       "is_amendment",
       "filing_date",
       "accession",
       "url",
       "structured",
       "issuer_name",
       "cusip",
       "security_class",
       "event_date",
       "purpose",
       "reporting_persons"
      ],
      "properties": {
       "url": {
        "type": "string"
       },
       "form": {
        "type": "string"
       },
       "cusip": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "purpose": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "schedule": {
        "enum": [
         "13D",
         "13G"
        ],
        "type": "string"
       },
       "accession": {
        "type": "string"
       },
       "event_date": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "structured": {
        "type": "boolean"
       },
       "filing_date": {
        "type": "string"
       },
       "issuer_name": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "is_amendment": {
        "type": "boolean"
       },
       "security_class": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "reporting_persons": {
        "type": "array",
        "items": {
         "type": "object",
         "required": [
          "reporting_person",
          "citizenship",
          "percent_of_class",
          "aggregate_shares_owned",
          "sole_voting_power",
          "shared_voting_power",
          "sole_dispositive_power",
          "shared_dispositive_power",
          "type_of_reporting_person",
          "type_of_reporting_person_label"
         ],
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-sec-edgar-schedule-13d-13g-beneficial-ownership-ef828dfb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)