# x402stock Beneficial Ownership Filings (Schedule 13D/13G) > x402stock Beneficial Ownership Filings (Schedule 13D/13G) is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-08). Retrieves SEC Schedule 13D and 13G beneficial ownership filings for a given stock ticker, showing large shareholders and their voting/dispositive power ## Facts - Endpoint: GET https://x402stock.xyz/api/v1/beneficial-ownership/%7Bticker%7D - Price: $0.02/call - Payment: x402 - Status: unknown - Last checked: 2026-09-08 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/x402stock-beneficial-ownership-filings-schedule-13d-13g-b301595f - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qGcK-Ptw-KAr5HHMAIVGj 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 x402stock-beneficial-ownership-filings-schedule-13d-13g-b301595f ``` Example prompt: Who are the major beneficial owners of Apple (AAPL) stock? Pull all recent 13D and 13G filings, up to 10 results. ## When to prefer this Use this endpoint when you need structured, parsed SEC beneficial ownership data (Schedule 13D/13G) for a specific US-listed company — especially when researching large institutional holders, activist investors, or ownership changes above the 5% threshold. Prefer this over general SEC full-text search when you need clean, machine-readable structured data with parsed reporting-person details rather than raw XML. ## Known failure modes - Unknown or invalid ticker symbol returns empty filings array or 404 - Ticker has no 13D/13G filings on record returns count of 0 - limit parameter out of range (>25 or <=0) returns validation error - Payment failure or insufficient USDC balance returns 402 Payment Required - Rate limiting or temporary SEC EDGAR upstream unavailability returns 5xx error ## How this service works Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base. ## Output Returns a JSON object containing the company name, CIK, and an array of beneficial ownership filings including the reporting person's name, citizenship, percent of class owned, aggregate shares, sole and shared voting/dispositive power, filing date, event date, amendment status, CUSIP, security class, and a link to the SEC EDGAR document. Also includes the data source (SEC EDGAR) and an as_of timestamp. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET", "HEAD", "DELETE" ], "type": "string" }, "queryParams": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "type", "limit" ], "properties": { "type": { "enum": [ "13D", "13G", "all" ], "type": "string", "default": "all" }, "limit": { "type": "integer", "default": 5, "maximum": 25, "exclusiveMinimum": 0 } }, "additionalProperties": false } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "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": [ … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "data": { "cik": "0000320193", "count": 1, "company": "Apple Inc.", "filings": [ { "url": "https://www.sec.gov/Archives/edgar/data/320193/000210011926000139/primary_doc.xml", "form": "SCHEDULE 13G", "cusip": "037833100", "purpose": null, "schedule": "13G", "accession": "0002100119-26-000139", "event_date": "2026-03-31", "structured": true, "filing_date": "2026-04-29", "issuer_name": "Apple Inc", "is_amendment": false, "security_class": "Common Stock", "reporting_persons": [ { "citizenship": "PA", "percent_of_class": 7.48, "reporting_person": "Vanguard Capital Management", "sole_voting_power": 145321305, "shared_voting_power": 0, "aggregate_shares_owned": 1099168953, "sole_dispositive_power": 1099168953, "shared_dispositive_power": 0, "type_of_reporting_person": "IA", "type_of_reporting_person_label": "Investment Adviser" } ] } ], "filings_parsed": 1 }, "as_of": "2026-04-29T00:00:00.000Z", "source": "sec_edgar", "ticker": "AAPL" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-beneficial-ownership-filings-schedule-13d-13g-b301595f/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)