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.

curl https://api.secpulse.app/v1/filings \
  -H "x-api-key: YOUR_API_KEY"

OpenAPI

The full API surface as a machine-readable OpenAPI 3 spec — generate clients, import into Postman, or build your own docs.

GET /v1/openapi.json

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.

GET /v1/filings?form=10-K&ticker=AAPL&from=2025-01-01&limit=50
GET /v1/filings?form=8-K&item=1.05   # cybersecurity-incident 8-Ks
→ { data: [...], meta: { nextCursor } }

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.

GET /v1/filings/0000320193-25-000079

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.

GET /v1/filings/0000320193-25-000079   → documents[]
GET /v1/filings/0000320193-25-000079/documents/aapl-20250927.htm
GET /v1/filings/0000320193-25-000079/documents/aapl-20250927.htm?format=markdown
GET /v1/filings/0000320193-25-000079/documents/FilingSummary.xml?format=json

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.

GET /v1/filings/0000320193-25-000079/sections?format=markdown
GET /v1/filings/0000320193-25-000079/sections?key=item_1a&format=html

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.

GET /v1/filings/0000320193-25-000079   → reports[].htmlFileName
GET /v1/filings/0000320193-25-000079/documents/R4.htm?format=text

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.

GET /v1/events?type=leadership_change&from=2026-01-01
GET /v1/events?ticker=AAPL

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.

GET /v1/filings/0000320193-25-000079/diff
GET /v1/filings/0000320193-25-000079/diff?section=item_1a&format=patch

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.

GET /v1/filings/0000320193-25-000079   → facts[]
GET /v1/companies/0000320193/facts?tag=Assets
GET /v1/companies/0000320193/facts?latest=true   # most recent value per tag

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).

GET /v1/facts?tag=Revenues&end=2025-09-30&unit=USD
GET /v1/facts?tag=Assets&frame=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.

GET /v1/companies/0000320193/financials?statement=income&period=annual&limit=8
GET /v1/companies/0000320193/financials?statement=balance&period=quarterly

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.

GET /v1/filings/:accession              → holdings[], transactions[]
GET /v1/holdings?cusip=037833             # 13F positions across managers
GET /v1/insider-trading?table=form144     # planned insider sales
GET /v1/insider-trading?form=144&issuerCik=0000715072
GET /v1/insider-trading/top?days=30&side=sell

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.

GET /v1/search?q=cybersecurity+incident&form=8-K
GET /v1/search?q=merger&scope=all&section=item_1a

Raw submission

The complete submission .txt — the SGML header plus every member document, exactly as filed.

GET /v1/filings/0000320193-25-000079/sgml

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=.

GET /v1/companies?ticker=AAPL
GET /v1/companies?q=apple
GET /v1/companies/0000320193
GET /v1/filings?cik=0000320193&form=8-K

Meta & feeds

Form-type discovery, ingest freshness, and an Atom feed of recent filings — alerting via any RSS reader, no webhook needed.

GET /v1/forms                        # every form type + filing count
GET /v1/status                       # latest filing seen + parse coverage
GET /v1/feed.atom?form=8-K&item=5.02 # Atom feed of matching filings

Bulk export

Export every filing matching your filters in one call — 1 credit per filing returned.

GET /v1/filings/export?form=10-K&from=2025-01-01

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.

POST https://your-app/webhooks/secpulse
x-secpulse-event: filing.created
x-secpulse-delivery-id: evt_9f3c…
x-secpulse-timestamp: 1731900000
x-secpulse-signature: t=1731900000,v1=5257a869…
x-credits-limit: 100000
x-credits-remaining: 99987
x-credits-reset: 1767225600

{
  "id": "evt_9f3c…",
  "type": "filing.created",
  "createdAt": "2026-11-18T14:02:11.412Z",
  "data": {
    "accessionNumber": "0000320193-25-000079",
    "form": "8-K",
    "cik": "0000320193",
    "company": { "name": "Apple Inc.", "tickers": ["AAPL"] }
  },
  "credits": { "limit": 100000, "remaining": 99987, "resetAt": 1767225600 }
}

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.

GET /v1/filings/export  →  meta.credits = filings returned

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.

x-ratelimit-limit: 120         # requests per minute for your plan
x-ratelimit-remaining: 119     # left in the current window
x-ratelimit-reset: 42          # seconds until the window resets
x-credits-limit: 100000        # monthly credit quota
x-credits-remaining: 99987     # left this month
x-credits-reset: 1767225600    # unix time of next monthly reset
x-cache: STALE                 # served from cache, revalidating in background
age: 51                        # seconds since this response was generated