Docs
Base URL: https://api.secpulse.app
Authentication
Create an API key in your portal, then send it as a bearer token or x-api-key header on every request.
OpenAPI
The full API surface as a machine-readable OpenAPI 3 spec — generate clients, import into Postman, or build your own docs.
List filings
Filter recent filings by form type, company CIK, ticker, 8-K item number, and filing-date range (from/to). Results are keyset-paginated — pass meta.nextCursor back as cursor for the next page.
A single filing
Everything for one accession number in one call: header fields, entities, documents, sections, financial reports — plus the embedded XBRL facts, 13F holdings, and insider transactions tagged to it. Empty fields are omitted from every response.
Filing documents
The filing's document list (metadata + SEC URLs) comes embedded in the filing itself; content downloads through us (raw by default, or text/markdown for HTML docs — parsed JSON for .xml docs) or via the included url.
Sections
Every Item/Part section in text, html, or markdown — filter by key or by member document (document=<filename>). The filing's section list (keys and titles) is embedded in the filing itself.
Financial reports
The filing's statement list from FilingSummary.xml comes embedded as reports[] — each entry's htmlFileName maps to a rendered R*.htm document.
Material events
8-K items classified into typed events — leadership_change (5.02), earnings_release (2.02), cybersecurity_incident (1.05), auditor_change (4.01), and more. Filter by semantic type or raw item number.
Filing diffs
Compare a filing's sections against the company's previous same-form filing (or any accession via against=<accession>) — per-section added/removed/changed/unchanged flags and line counts, or a unified diff with format=patch. The 'what changed in risk factors' endpoint.
XBRL facts
Structured XBRL facts — embedded per filing, or the company's whole history (like SEC's companyconcept). Filter by taxonomy, tag, unit, and form; latest=true returns the most recent value per concept.
Cross-company facts
One XBRL tag across every company — the SEC 'frames' lookup. Query by exact period end or an SEC frame id (CY2025Q3, CY2025Q3I).
Financial statements
XBRL facts normalized into income statement, balance sheet, or cash flow line items across annual or quarterly periods (period=all returns both) — no tag wrangling. Includes a computed freeCashFlow line on cashflow.
Form-specific data
Structured rows for supported form types, embedded in the filing (holdings[], transactions[]): 13F information-table holdings and ownership transactions — Form 3/4/5 (nonDerivative/derivative tables) plus Form 144 planned affiliate sales (table=form144; prior-3-month sales come back as form144Sold). Cross-filing queries go through the global lists — /v1/holdings by cusip/issuer/manager, /v1/insider-trading by owner/issuer/code/side/table, plus /v1/insider-trading/top for the largest buys and sells by dollar value.
Full-text search
Search filing text with highlighted hits. scope=sections (default) covers extracted Item/Part sections; scope=documents searches exhibit text instead — press releases live in EX-99 files outside section cuts; scope=all searches both. Results are offset-paginated — meta.total reports the full hit count.
Raw submission
The complete submission .txt — the SGML header plus every member document, exactly as filed.
Companies & tickers
Search companies by name, ticker, or SIC — ?ticker= also resolves a symbol straight to its CIK(s). Get the full profile by CIK; page filing history via /v1/filings?cik=.
Meta & feeds
Form-type discovery, ingest freshness, and an Atom feed of recent filings — alerting via any RSS reader, no webhook needed.
Bulk export
Export every filing matching your filters in one call — 1 credit per filing returned.
Webhooks
Create endpoints in your portal to receive filing.created, insider.filing.created, and company.updated events — optionally filtered by form, CIK, ticker, 8-K item, or full-text keywords matched against the filing's sections, with optional custom request headers. Deliveries are signed: verify x-secpulse-signature (t={unix_seconds},v1={hmac-sha256 of `${t}.${body}`}) with your endpoint's whsec_ secret. Failed deliveries retry with exponential backoff for ~30 minutes. The signed credits block and matching x-credits-* headers report your monthly quota after this delivery.
Credits
1 API request = 1 credit, 1 webhook event = 1 credit, 1 exported filing = 1 credit. Credits reset on the first of each month and are shared across API + webhook usage.
Rate limits & credits
Every response reports your key's per-minute rate limit and remaining monthly credits. 429 responses include a retry-after header. GETs are served from a short-lived shared cache — x-cache (MISS/HIT/STALE) and age tell you how fresh the response is; cached hits still count against your plan.