Lookup Filings

GET/v1/lookup

Retrieve SEC filings based on various search criteria including CIK, ticker symbol, form type, and date range.

Parameters

Name	Type	Required	Description
`api_key`	string	Required	Your API authentication key `Example: sk_live_abc123...`
`cik`	string	Optional	Comma-separated list of CIK numbers (10-digit identifiers) `Example: 0001318605,0001640147`
`ticker`	string	Optional	Comma-separated list of stock ticker symbols `Example: TSLA,AAPL,MSFT`
`sic`	string	Optional	Comma-separated list of SIC (Standard Industrial Classification) codes `Example: 3711,7372`
`form_type`	string	Optional	Comma-separated list of form types to filter `Example: 10-K,10-Q,8-K,DEF 14A`
`from_date`	string	Optional	Start date for filing date range (ISO 8601 format) `Example: 2024-01-01`
`to_date`	string	Optional	End date for filing date range (ISO 8601 format) `Example: 2024-12-31`

Examples

Request

curl -X GET "https://api.secblastapi.com/v1/lookup?ticker=AAPL&form_type=10-K&from_date=2024-01-01" \
  -H "X-API-Key: your_api_key"

Response

{
  "response_details": {
    "filings_found": 1,
    "errors": []
  },
  "filings": [
    {
      "accnum": "0000320193-24-000008",
      "documents": [
        {
          "document_id": "0000320193-24-000008-1",
          "form_type": "10-K",
          "description": "ANNUAL REPORT",
          "size": 4856732,
          "file_name": "aapl-20230930.htm"
        }
      ],
      "form_type": "10-K",
      "filing_date": "2024-02-02",
      "period": "2023-09-30",
      "tickers": ["AAPL"],
      "filer_details": {
        "cik": "0000320193",
        "name": "APPLE INC",
        "tickers": ["AAPL"]
      }
    }
  ]
}

Response Schema

response_details

Type: object

Metadata about the response

filings_found:Number of filings matching the criteria

errors:Array of any errors encountered during processing

filings

Type: array

Array of filing objects matching the search criteria

accnum:Accession number - unique identifier for the filing

documents:Array of document objects within the filing

form_type:Type of SEC form (e.g., 10-K, 10-Q, 8-K)

filing_date:Date the filing was submitted to the SEC

period:Reporting period end date

tickers:Array of ticker symbols associated with the filing

filer_details:Object containing filer information (CIK, name, tickers)

Error Responses

400Bad Request - Invalid parameters

{
  "error": "Invalid date format. Please use YYYY-MM-DD"
}

401Unauthorized - Invalid or missing API key

{
  "error": "Invalid API key"
}

429Too Many Requests - Rate limit exceeded

{
  "error": "Rate limit exceeded. Please try again later."
}

Important Notes

• At least one search parameter (cik, ticker, sic, or form_type) must be provided
• Date ranges are inclusive of both from_date and to_date
• Results are sorted by filing date in descending order (newest first)
• Maximum of 1000 filings returned per request
• CIK numbers must be zero-padded to 10 digits
• Ticker symbols are case-insensitive

Try It Out

Test this endpoint interactively in our API Playground

Open in Playground →