get_filing_structured
Get Structured Filing Data
What it does
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; use valueUsd / totalMarketValueUsd (dollars; null when the unit cannot be determined) and valueUnit. Holdings are capped at holdingsLimit (default 200); holdingsTotal is the full count, holdingsTruncated says whether rows were cut.
NULL MEANS NOT STATED IN THE FILING, never 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; read those with get_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; check SEC EDGAR for earlier periods. Record-only rows (bodyStored: false) have no stored body; open them at their sec.gov URL.
Ask your AI
With the Signal8 MCP server connected, your assistant calls this tool when a question needs it. For example:
Use Signal8's get_filing_structured tool.
Parameters
| Name | Type | Description |
|---|---|---|
accessionNumberrequired | string | SEC accession number of a Form 3/4/5, 13F-HR or SCHEDULE 13D/G, dashed or 18-digit compact form |
holdingsLimitoptional | integer | 13F only: max holdings rows to return (default 200, max 5000) |
Other SEC filings & EDGAR tools
- get_exhibit_contentFull text/HTML of a single exhibit.
- get_filing_documentFull raw text/HTML of a filing by internal id.
- get_filing_documentsEvery document in a filing, with the ids to read each one.
- get_filing_exhibitsList the readable exhibits within a filing.
- lookup_accession_numberLook up a filing/exhibit by accession number.
- screen_sec_filingsScreen filings across all companies by company + filing filters.
- screen_sec_filings_performancePrice performance after filings, with aggregate stats.
- search_filing_textFull-text search that returns the matching passage per filing.
- search_sec_filingsSearch filings by CIK, form, date, 8-K items, full text, or company filters (market cap, float, sector, exchange...).