SEC Blast API

GET/v2/filing_lookup

Search SEC filings with filters for entity, form type, date range, and 8-K items. Returns filing metadata, documents, and 8-K item details.

Request Parameters

Name	Type	Description
`api_key`required	string	Your API key.
`entity_query`	object	Entity filter using entity_lookup fields (tickers, ciks, etc.)
`form_types`	string[]	Form types to include. Example: `["10-K", "10-Q", "8-K"]`
`excluded_form_types`	string[]	Form types to exclude. Example: `["4", "SC 13G"]`
`exclude_amendments`	boolean	Exclude amendment filings (10-K/A, 8-K/A, etc.). Default: false
`items`	string[]	8-K item numbers. Example: `["1.01", "2.02", "5.02"]`
`date_from`	string	Start date. Example: `YYYY-MM-DD`
`date_to`	string	End date. Example: `YYYY-MM-DD`
`sort_by`	string	Sort field: filing_date, acceptance_date_time, form, size, entity_name
`sort_order`	string	Sort order: asc, desc. Default: desc
`from`	number	Pagination start. Default: 0
`to`	number	Pagination end. Default: 10000, Max: 10000

Examples

Get 10-K Filings for a Company

bash

curl -X GET "https://api.secblast.com/v2/filing_lookup" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "entity_query": {"tickers": ["AAPL"]},
    "form_types": ["10-K"],
    "from": 0,
    "to": 10
  }'

Find 8-K Filings with Leadership Changes

bash

curl -X GET "https://api.secblast.com/v2/filing_lookup" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "form_types": ["8-K"],
    "items": ["5.02"],
    "date_from": "2024-01-01",
    "date_to": "2024-12-31"
  }'

200Success

{
  "count": 25,
  "filings": [
    {
      "accession_number": "0000320193-24-000081",
      "cik": "320193",
      "form_type": "10-K",
      "filing_date": "2024-11-01",
      "acceptance_datetime": "2024-11-01T06:01:23",
      "entity_name": "Apple Inc.",
      "report_date": "2024-09-28",
      "size": 15234567,
      "documents": [
        {
          "document_id": "0000320193-24-000081-1",
          "sequence": 1,
          "filename": "aapl-20240928.htm",
          "description": "10-K",
          "type": "10-K"
        }
      ]
    }
  ],
  "truncated": false
}