{"uid":"cap_qGcK-Ptw-KAr5HHMAIVGj","slug":"x402stock-beneficial-ownership-filings-schedule-13d-13g-b301595f","name":"x402stock Beneficial Ownership Filings (Schedule 13D/13G)","description":"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.","url":"https://x402stock.xyz/api/v1/beneficial-ownership/%7Bticker%7D","method":"GET","headers":{},"bodySchema":{"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":[{"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"],"properties":{"citizenship":{"anyOf":[{"type":"string"},{"type":"null"}]},"percent_of_class":{"anyOf":[{"type":"number"},{"type":"null"}]},"reporting_person":{"anyOf":[{"type":"string"},{"type":"null"}]},"sole_voting_power":{"anyOf":[{"type":"number"},{"type":"null"}]},"shared_voting_power":{"anyOf":[{"type":"number"},{"type":"null"}]},"aggregate_shares_owned":{"anyOf":[{"type":"number"},{"type":"null"}]},"sole_dispositive_power":{"anyOf":[{"type":"number"},{"type":"null"}]},"shared_dispositive_power":{"anyOf":[{"type":"number"},{"type":"null"}]},"type_of_reporting_person":{"anyOf":[{"type":"string"},{"type":"null"}]},"type_of_reporting_person_label":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false}},"filings_parsed":{"type":"number"}},"additionalProperties":false},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string","const":"sec_edgar"},"ticker":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yNanARHHTaqBkJ4M5g8ZH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves SEC Schedule 13D and 13G beneficial ownership filings for a given stock ticker, showing large shareholders and their voting/dispositive power","exampleAgentPrompt":"Who are the major beneficial owners of Apple (AAPL) stock? Pull all recent 13D and 13G filings, up to 10 results.","exampleUseCases":[{"title":"Identify activist investors in stock","prompt":"Have any activists filed a Schedule 13D on GameStop recently? I want to know who they are, how many shares they hold, and when they filed."},{"title":"Check institutional ownership above 5%","prompt":"Which institutional investors have disclosed owning more than 5% of NVDA? Pull their names, share counts, and voting power from the latest 13D and 13G filings."},{"title":"Research Vanguard stake in ETF","prompt":"What is Vanguard's current beneficial ownership stake in the SPDR S&P 500 ETF (SPY)? Show me their most recent 13G filing details including shares and percent of class."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T12:57:28.888Z","isFirstParty":false}