What it returns
Anyone who acquires more than 5% of a class of a US-listed company's voting shares must file Schedule 13D (if they may seek to influence the company) or Schedule 13G (passive holders) with the SEC. This API reads those filings from EDGAR and returns one row per reporting person. - **By company**: tickers or CIKs; every 13D/13G filed about them in the date range - **Market-wide**: leave companies empty for the latest filings across EDGAR (default: last 3 days)
| field | meaning |. |---|---|. | `form`, `kind`, `amendment`, `amendmentNo` | SCHEDULE 13D / 13G and amendments |. | `issuerName`, `issuerCik`, `cusip`, `securityClass` | the company and share class |. | `reportingPerson`, `reportingPersonCik`, `personType`, `citizenship` | the holder (IA adviser, CO corporation, IN individual, PN partnership ..) |. | `shares`, `percentOfClass` | aggregate beneficial ownership |. | `soleVoting`, `sharedVoting`, `soleDispositive`, `sharedDispositive` | voting and dispositive power |. | `eventDate` | the date of the event that required the filing |. | `filedDate`, `acceptedAt` | when it became public (acceptedAt for company lookups) |. | `purpose`, `sourceOfFunds` | 13D only: Item 4 purpose of the transaction and Item 3 source of funds |. | `accession`, `url` | the filing on EDGAR |. Filings made before EDGAR's structured format (December 2024) come back as link-only rows with `parseStatus`; set `parsedOnly` to leave them out.
Request
POST https://api.pushbuild.com/sec-13d-13g-stakes/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
tickers | list of strings | Stakes filed about these companies. Leave empty (and ciks empty) for the latest filings across the market. |
ciks | list of strings | SEC CIK numbers, for companies without a ticker. |
kind | string: both, 13d, 13g | 13D is filed by holders who may seek to influence the company; 13G by passive holders. Default: "both". |
days | integer | Default 3 days for the market-wide feed, 365 days for named companies. Ignored when fromDate is set. |
fromDate | string | First filing date. Optional. |
toDate | string | Last filing date. Defaults to today. |
includeAmendments | boolean | Include 13D/A and 13G/A (stake changes and exits). Default: true. |
minPercent | number | Only reporting persons at or above this ownership percent. |
parsedOnly | boolean | Leave out pre-December-2024 text filings, which come back as link-only rows. Default: false. |
maxFilings | integer | Newest first. A filing can have several reporting persons. Default: 200. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/sec-13d-13g-stakes/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"tickers": ["AAPL"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.80 per 1,000 stakes. No charge for errors or empty searches.
Related APIs
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Cboe Put/Call Ratios & VIX Futures Term Structure API
Daily Cboe options statistics: total, equity, index, SPX and VIX put/call ratios with call and put volume and open interest by product, plus the VIX futures curve with settlements, open interest and contango versus spot VIX..
CFPB Consumer Complaints: Banks, Lenders, Fintech API
Search 18 million+ official CFPB consumer complaints against banks, lenders, card issuers, debt collectors, credit bureaus and fintechs.
CFTC Commitments of Traders (COT) Reports API
Weekly CFTC Commitments of Traders positioning for every futures market: legacy, disaggregated (managed money, producers, swap dealers) and financial (leveraged funds, asset managers).
ClinicalTrials.gov API
Search 500,000+ clinical studies from ClinicalTrials.gov by condition, drug, sponsor, location, phase and status.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com