Document Lookup API

Find SEC filings by company, form type, and date range

Overview

Endpoint

GET api.secblast.com/v1/lookup

Description

Retrieve filings based on various criteria including CIK, ticker, form type, and date range. Including additional CIKs, tickers, and SICs broadens the search. Specifying form types and a date range will narrow the search. from_date can be specified without to_date, and vice versa.

Request Parameters

Parameter	Type	Description
api_key	string	RequiredYour API key
ciks	string	Comma-separated list of CIK numbers (e.g., `0000002488,0001318605`)
tickers	string	Comma-separated list of ticker symbols (e.g., `AMD,NVDA`)
sics	string	Comma-separated list of SIC codes
form_types	string	Comma-separated list of form types (e.g., `10-K,10-Q,8-K`)
from_date	string	Start date in ISO format (YYYY-MM-DD)
to_date	string	End date in ISO format (YYYY-MM-DD)

Response Format

{
  "response_details": {
    "filings_found": 2,
    "errors": []
  },
  "filings": [
    {
      "accnum": "0000002488-24-000012",
      "documents": [
        {
          "document_id": "0000002488-24-000012-1",
          "form_type": "10-K",
          "description": "10-K",
          "size": 2625832,
          "file_name": "amd-20231230.htm"
        },
        {
          "document_id": "0000002488-24-000012-2",
          "form_type": "EX-21",
          "description": "EX-21",
          "size": 67128,
          "file_name": "ex21-10kfy23.htm"
        }
      ],
      "form_type": "10-K",
      "filing_date": "2024-01-31T00:00:00Z",
      "period": "2023-12-30",
      "period_focus": "FY",
      "related_companies": [
        {
          "name": "ADVANCED MICRO DEVICES INC",
          "cik": "0000002488",
          "ticker": "AMD"
        }
      ]
    }
  ]
}

Example Request

curl "https://api.secblast.com/v1/lookup?api_key=YOUR_API_KEY&tickers=AMD&form_types=10-K"

Error Responses

401 Unauthorized: Invalid API key

{
  "response_details": {
    "filings_found": 0,
    "errors": ["Invalid API key"]
  },
  "filings": []
}

400 Bad Request: Invalid parameters

{
  "response_details": {
    "filings_found": 0,
    "errors": ["Invalid date format"]
  },
  "filings": []
}