Get Structured Filing Data
get_filing_structuredExtracts parsed, machine-readable data from SEC ownership and holdings filings by accession number, delivering structured transactions, holdings, and reporting persons for analysis.
Instructions
Parsed, machine-readable data from an ownership or holdings filing, by accession number. kind: "ownership" (Form 3/4/5 and amendments): issuer, reporting owners with relationship (director, officer title, 10% owner, or the filer's own "Other" text) and parsed.transactions (per transaction: table nonDerivative/derivative, securityTitle, transactionDate, code, acquiredDisposed A/D, shares, pricePerShare, sharesOwnedAfter, ownership D/I; derivatives add exercisePrice, exerciseDate, expirationDate, underlyingTitle, underlyingShares); "thirteen_f" (13F-HR): period, holdings with cusip, issuer, shares/principal, put/call, discretion and voting; "schedule13" (XML SCHEDULE 13D/G, 2025 onward): reporting persons, percent of class, items. 13F VALUES: valueThousands is the raw filed number, whose unit changed from thousands to whole dollars for filings on/after 2023-01-03; valueUsd / totalMarketValueUsd are normalised to dollars (null when the unit cannot be determined) and valueUnit names the unit. Holdings are capped at holdingsLimit (default 200); holdingsTotal is the full count, holdingsTruncated says whether rows were cut. A null value means not stated in the filing; it does not mean zero (a gift with no price has pricePerShare null; directShares is null on a derivative-only Form 4). parsed.transactions absent (not empty) means the table could not be read; totals still apply. parsed: null on a 13F means no information table (e.g. 13F-NT), not zero holdings. Unsupported forms, pre-2025 Schedule 13D/G and filings not in the archive return a not-found error with details.reason; their raw text remains readable as a filing document. Coverage: Signal8's SEC EDGAR archive, updated through the day, in its held range (see archiveFrom in each response; currently from late 2021, expanding back to 2016 as the history backfill fills in). Before archiveFrom it holds only a scatter, so absence before archiveFrom is not evidence a filing was never filed; SEC EDGAR itself covers earlier periods. Record-only rows (bodyStored: false) have no stored body; the document is at its sec.gov URL.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"accessionNumber": "<accessionNumber>"
},
"name": "get_filing_structured"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| holdingsLimit | No | 13F only: max holdings rows to return (default 200, max 5000) | |
| accessionNumber | Yes | SEC accession number of a Form 3/4/5, 13F-HR or SCHEDULE 13D/G, dashed or 18-digit compact form |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No |