8-K Disclosures

GET
/stocks/filings/8-K/vX/disclosures
This endpoint is free to use during the early-access beta period. Features may change or move to different plans later.

SEC 8-K filing disclosure categorization. Each material event in a filing (leadership changes, acquisitions, material agreements, regulatory actions, etc.) is classified into a consistent three-tier taxonomy (primary, secondary, tertiary) with a supporting text excerpt directly from the filing.

A single filing can produce multiple records when it contains multiple disclosures. Each record represents one tagged disclosure within the filing. The full taxonomy is available at /stocks/taxonomies/vX/disclosures.

Use Cases: Event detection and alerts, event-driven trading strategies, M&A tracking, leadership-change monitoring, and corporate-action timelines.

Plan AccessIncluded in all Stocks plans
Stocks BasicFree
Updated daily
Stocks Starter$29/mo
Updated daily
Stocks Developer$79/mo
Updated daily
Stocks Advanced$199/mo
Updated daily
Plan RecencyUpdated daily
Plan HistoryNot applicable to this endpoint
Query Parameters
cik
string
SEC Central Index Key of the filer (10 digits, zero-padded).
tickers
string
Filter for arrays that contain the value.
filing_date
string
Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD).
tertiary_category
string
Most specific disclosure category (e.g., 'quarterly_results'). Filtering on this column must use an exact match. See the full taxonomy at /stocks/taxonomies/vX/disclosures.
limit
integer
Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '1000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'filing_date' if not specified. The sort order defaults to 'desc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
accession_number
string
optional
Unique SEC accession number for the filing (e.g., '0000320193-25-000010').
cik
string
optional
SEC Central Index Key of the filer (10 digits, zero-padded).
filing_date
string
optional
Date when the filing was submitted to the SEC (formatted as YYYY-MM-DD).
filing_url
string
optional
Direct URL to the full submission text file for the filing on SEC EDGAR.
primary_category
string
optional
Top-level disclosure category (e.g., 'financial_results'). See the full taxonomy at /stocks/taxonomies/vX/disclosures.
secondary_category
string
optional
Mid-level disclosure category (e.g., 'earnings_announcement'). See the full taxonomy at /stocks/taxonomies/vX/disclosures.
supporting_text
string
optional
A verbatim excerpt from the filing text supporting the assigned categories.
tertiary_category
string
optional
Most specific disclosure category (e.g., 'quarterly_results'). Filtering on this column must use an exact match. See the full taxonomy at /stocks/taxonomies/vX/disclosures.
tickers
array (string)
optional
A list of ticker symbols for the filing company. Multiple symbols may indicate different share classes; empty if no ticker is currently mapped to the filer.
status
enum (OK)
The status of this request's response.
Code Examples
curl -X GET "https://api.massive.com/stocks/filings/8-K/vX/disclosures"
Query URL
GET
https://api.massive.com/stocks/filings/8-K/vX/disclosures?apiKey=YOUR_API_KEY
Run query unavailable
Create account or sign in to Massive
Scroll to see updated query response
Response Object
{
  "count": 2,
  "next_url": "https://api.massive.com/stocks/filings/8-K/vX/disclosures?cursor=eyJsaW1pd...",
  "request_id": "b4e7c2a1f3d8e9g0",
  "results": [
    {
      "accession_number": "0000320193-25-000010",
      "cik": "0000320193",
      "filing_date": "2025-01-14",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/0000320193-25-000010.txt",
      "primary_category": "financial_results",
      "secondary_category": "earnings_announcement",
      "supporting_text": "On January 14, 2025, Apple Inc. announced financial results for the fiscal quarter ended December 28, 2024.",
      "tertiary_category": "quarterly_results",
      "tickers": [
        "AAPL"
      ]
    },
    {
      "accession_number": "0000004962-25-000002",
      "cik": "0000004962",
      "filing_date": "2025-01-15",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/4962/0000004962-25-000002.txt",
      "primary_category": "regulatory_compliance",
      "secondary_category": "regulation_fd",
      "supporting_text": "American Express Company is hereby furnishing below delinquency and write-off statistics for its U.S. Consumer and Small Business portfolios.",
      "tertiary_category": "financial_data_disclosure",
      "tickers": [
        "AXP"
      ]
    }
  ],
  "status": "OK"
}
Did you find this page helpful?
Do you still need help with something?