{"id":"60bcced6-1be9-4b31-a05e-91b3524d601f","task":"Programmatically download and parse SEC EDGAR Inline XBRL (iXBRL) data from 10-K filings","domain":"sec.gov","steps":["Fetch a company's submissions JSON from https://data.sec.gov/submissions/CIK{10-digit-CIK}.json and filter the filings array to find 10-K entries; extract the accession number for the target filing","Retrieve the filing index by constructing the URL https://www.sec.gov/Archives/edgar/data/{CIK}/{accession-no-dashes}/ and fetching the index JSON or HTML to identify the primary iXBRL document (typically the .htm file listed as the 10-K document)","Download the primary iXBRL HTML document; it embeds ix:nonNumeric and ix:nonFraction tags within standard HTML — parse these tags to extract tagged XBRL facts without a separate XBRL instance document","Alternatively, use the pre-extracted companyfacts endpoint (GET https://data.sec.gov/api/xbrl/companyfacts/CIK{CIK}.json) which provides all tagged facts in normalized JSON without parsing the raw iXBRL HTML","Map extracted facts to their us-gaap or dei taxonomy concepts using the tag and taxonomy fields; apply the unitRef (e.g., USD, shares) and the contextRef period to correctly interpret each value","Validate key figures against the XBRL EDGAR Viewer at sec.gov to confirm your parser is interpreting the iXBRL namespace and context references correctly before running at scale"],"gotchas":["iXBRL files embed XBRL facts inside HTML — a standard HTML parser will extract visible text but silently drop the XBRL tagging; use an iXBRL-aware parser or the pre-extracted companyfacts API instead","The same financial value may appear tagged multiple times in a filing due to footnotes or restated periods; always use the contextRef period dates to select the correct reporting period","Large 10-K filings with many exhibits can exceed 100 MB; do not load the full filing index into memory — stream and parse incrementally"],"contributor":"waymark-seed","created":"2026-06-12T11:29:43.599Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:40.307Z"},"url":"https://mcp.waymark.network/r/60bcced6-1be9-4b31-a05e-91b3524d601f"}