SEC Blast API

GET/v2/entity_lookup

Search and filter SEC filers by CIK, ticker, exchange, SIC code, state, or name. Returns entity details including tickers, addresses, and filing history.

Required Parameters

Name	Type	Description
`api_key`required	string	Your API key for authentication

Search Parameters

Name	Type	Description
`tickers`	string[]	Filter by stock ticker symbols Example: `["AAPL", "MSFT"]`
`ciks`	string[]	Filter by CIK numbers Example: `["320193", "789019"]`
`name_includes`	string[]	Substrings that must appear in entity name Example: `["APPLE"]`
`name_excludes`	string[]	Substrings to exclude from entity name Example: `["HOLDINGS"]`
`exchanges`	string[]	Filter by exchange. Valid values: NASDAQ, NYSE, OTC, CBOE Example: `["NASDAQ"]`
`sics`	string[]	Filter by SIC industry codes Example: `["7372", "3674"]`
`states`	string[]	Filter by state of incorporation Example: `["DE", "CA"]`
`entity_types`	string[]	Filter by entity type. Valid values: OPERATING, INVESTMENT, OTHER

Pagination

Name	Type	Description
`from`	number	Start index for pagination. Default: 0
`to`	number	End index for pagination. Default: 100, Max: 10000

Examples

Lookup by Ticker

cURL

curl "https://api.secblast.com/v2/entity_lookup?api_key=YOUR_KEY&tickers=AAPL"

Search by Name

cURL

curl "https://api.secblast.com/v2/entity_lookup?api_key=YOUR_KEY&name_includes=APPLE"

Filter by Exchange and State (JSON body)

cURL

curl -X GET "https://api.secblast.com/v2/entity_lookup" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "exchanges": ["NASDAQ"],
    "states": ["CA"],
    "from": 0,
    "to": 50
  }'

Response

200Success

{
  "count": 1,
  "entities": [
    {
      "cik": "320193",
      "name": "Apple Inc.",
      "tickers": ["AAPL"],
      "exchanges": ["NASDAQ"],
      "sic": "3571",
      "sic_description": "Electronic Computers",
      "state_of_incorporation": "CA",
      "fiscal_year_end": "0930",
      "entity_type": "OPERATING",
      "category": "Large accelerated filer",
      "addresses": {
        "business": {
          "street1": "ONE APPLE PARK WAY",
          "city": "CUPERTINO",
          "state": "CA",
          "zip": "95014"
        }
      }
    }
  ],
  "response_bytes": 456,
  "truncated": false
}

400Error

{
  "error": "Invalid or missing API key"
}