What is an 8-K and why should I care?

When something important happens at a public company, they report it to the SEC via an 8-K. We translate it into plain English and send it to your phone in under 60 seconds.

Do you have a developer API?

Yes. REST API, WebSocket streaming, MCP server, and A2A protocol. Developer plans start at $29/mo. Python and JavaScript SDKs with full documentation.

How fast is it really?

Median delivery time is 38 seconds from SEC filing to your phone. That’s 20–40 minutes before financial news articles cover the same event.

The mobile app and web dashboard are free. Developer API starts at $29/mo for REST, WebSocket, and MCP access. Pro plans available at $99/mo.

REST API

Developer

Structured JSON endpoints for filings, companies, watchlists, and earnings. All responses follow a consistent format with pagination metadata.

Base URLhttps://api.8kintel.com

AuthAuthorization: Bearer YOUR_API_KEY

Content-Typeapplication/json

Filings

GET/api/v1/filingsAuth

List filing events, paginated and filterable by ticker, index, category, and sentiment.

Parameter	Type	Description
`limit`	integer	Results per page (1–100, default 20)
`offset`	integer	Pagination offset (default 0)
`ticker`	string	Filter by ticker symbol (e.g. AAPL). Mutually exclusive with index_id.
`index_id`	string	Filter by market index (sp500, nasdaq100, djia). Mutually exclusive with ticker.
`category`	string	Filing category: earnings, mna, leadership, cyber, financial, governance, other
`sentiment`	string	AI sentiment: bullish, bearish, neutral

Example response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "ticker": "AAPL",
      "company_name": "Apple Inc.",
      "accession_number": "0000320193-26-000042",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/...",
      "filed_at": "2026-03-14T16:30:00Z",
      "items": ["2.02", "9.01"],
      "summary": {
        "headline": "Q1 2026 revenue beats estimates by 8%",
        "sentiment": "bullish",
        "bullet_1": "Revenue $124.3B vs $115.2B est.",
        "bullet_2": "Services segment hits all-time high at $26.1B",
        "bullet_3": "Guidance raised for Q2 2026",
        "guidance_change": "raised",
        "beat_miss": "beat",
        "exhibits": [
          { "type": "EX-99.1", "filename": "ex991.htm", "url": "https://..." }
        ]
      },
      "e2e_latency_ms": 38200,
      "created_at": "2026-03-14T16:30:38Z"
    }
  ],
  "meta": { "total": 1842, "limit": 20, "offset": 0 }
}

GET/api/v1/filings/{id}Auth

Get a single filing by UUID. Returns full detail including exhibit metadata and AI analysis.

Parameter	Type	Description
`id`required	string	Filing UUID

GET/api/v1/filings/watchlistAuth

List filings for tickers on the authenticated user's watchlist. Includes read/unread status.

Parameter	Type	Description
`limit`	integer	Results per page (1–100, default 20)
`offset`	integer	Pagination offset (default 0)
`ticker`	string	Filter by ticker
`category`	string	Filing category filter
`sentiment`	string	Sentiment filter
`read`	string	Read status: true or false

POST/api/v1/filings/{id}/readAuth

Mark a filing as read.

DELETE/api/v1/filings/{id}/readAuth

Mark a filing as unread.

POST/api/v1/filings/read-allAuth

Mark all watchlist filings as read. Returns count of newly marked filings.

POST/api/v1/filings/{id}/pinAuth

Pin a filing to your dashboard.

DELETE/api/v1/filings/{id}/pinAuth

Unpin a filing from your dashboard.

Companies

GET/api/v1/companies/search?q={query}Auth

Search companies by ticker or name using trigram fuzzy matching. Returns up to 50 results.

Parameter	Type	Description
`q`required	string	Search query (ticker or company name)
`limit`	integer	Max results (1–50, default 20)

GET/api/v1/companies/{ticker}Auth

Get company detail including indices, watchlist status, and recent filings.

Parameter	Type	Description
`ticker`required	string	Stock ticker symbol

GET/api/v1/companies/trendingAuth

Trending companies by recent filing activity (last 48 hours).

Parameter	Type	Description
`limit`	integer	Max results (1–50, default 10)

Watchlist

GET/api/v1/watchlistAuth

Get the authenticated user's watchlist with company names, latest filing info, and 30-day filing count.

POST/api/v1/watchlistAuth

Add a ticker to the watchlist.

Parameter	Type	Description
`ticker`required	string	Ticker symbol to watch (e.g. AAPL)

DELETE/api/v1/watchlist/{ticker}Auth

Remove a ticker from the watchlist.

Parameter	Type	Description
`ticker`required	string	Ticker to remove

Earnings

GET/api/v1/earnings/upcomingAuth

List upcoming earnings dates for SEC-filing companies.

Parameter	Type	Description
`days`	integer	Lookahead window in days (1–90, default 14)
`limit`	integer	Results per page (1–100, default 20)
`offset`	integer	Pagination offset (default 0)

Earnings entry shape

{
  "id": "...",
  "ticker": "AAPL",
  "company_name": "Apple Inc.",
  "earnings_date": "2026-04-24",
  "earnings_time": "AMC",
  "fiscal_quarter": "Q2 2026",
  "eps_estimate": "1.62",
  "num_estimates": 38,
  "market_cap": "3.2T",
  "days_until": 41
}

Dashboard

GET/api/v1/dashboardAuth

Get dashboard overview: unread count, filing stats, risk filings, and pinned filings.

Devices

GET/api/v1/devicesAuth

List registered push notification devices (tokens masked).

POST/api/v1/devicesAuth

Parameter	Type	Description
`platform`required	string	ios or android
`device_token`required	string	APNs or FCM device token

DELETE/api/v1/devices/{id}Auth

Remove a registered device.

Preferences

GET/api/v1/preferencesAuth

Get user notification preferences (per-category toggles).

PUT/api/v1/preferencesAuth

Update notification preferences.

Example body

{
  "real_time_alerts": true,
  "earnings": true,
  "mna": true,
  "leadership": false,
  "cyber": true,
  "financial": false
}

API Keys

POST/api/v1/api-keysAuth

Create a new API key. The full key is only returned once — store it securely.

Parameter	Type	Description
`name`required	string	Friendly name for the key (e.g. 'Trading Bot')

GET/api/v1/api-keysAuth

List your API keys (prefix only, not the full key).

GET/api/v1/api-keys/{id}/usageAuth

Get usage stats for a specific API key.

DELETE/api/v1/api-keys/{id}Auth

Revoke an API key. This action cannot be undone.

Error Responses

All errors return a consistent JSON shape:

{ "error": "description of what went wrong", "code": "ERROR_CODE" }

HTTP	Code	Meaning
400	BAD_REQUEST	Invalid parameters or body
401	UNAUTHENTICATED	Missing or invalid auth token
403	TIER_REQUIRED	Feature requires a higher subscription tier
404	NOT_FOUND	Resource does not exist
429	RATE_LIMITED	Rate limit exceeded — check Retry-After header