Skip to content

GET /v3/entities/{cik_or_ticker}

Get one company or person by CIK or ticker.

Returns the latest details as filed, SEC's current record (current), the roles seen, and filing counts. The answer is 404 when neither SEC Blast nor SEC's snapshot knows the CIK.

Tickers are under current.tickers, with their exchanges under current.listed. Both come from SEC's ticker file, which also lists unusual symbols such as GOOGM and GOOGN.

API key: required. See Authentication.

Group: Entities

Try it

Parameters

The company's CIK, such as 320193, or its ticker, such as AAPL. Leading zeros are optional. A ticker is looked up in SEC's ticker file, in any letter case. An unknown ticker is a 400 unknown_ticker error. The resolved member gives the CIK.

Without a key the API answers 401; you can still send the request to see that.
Python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/entities/AAPL",
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

Response

Nothing has been sent yet.

Parameters

NameInTypeRequiredDefaultDescription
cik_or_tickerpathstringyesThe company's CIK, such as 320193, or its ticker, such as AAPL. Leading zeros are optional. A ticker is looked up in SEC's ticker file, in any letter case. An unknown ticker is a 400 unknown_ticker error. The resolved member gives the CIK.

Details

Snapshot: when this server has no snapshot store configured, the answer is 404 whenever SEC Blast has no filing for the CIK. When the snapshot store is unavailable and SEC Blast has no filing for the CIK, the answer is 200 with data null, because the CIK cannot be checked.

Responses

StatusBodyDescription
200Entity (application/json)OK
400Problem (application/problem+json)Invalid or unknown parameter.
401Problem (application/problem+json)Missing, invalid, or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728).
404Problem (application/problem+json)Not found.
503Problem (application/problem+json)Database unavailable; retry after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a Entity object.

FieldTypeRequiredDescription
addressesAddressesno
as_ofobject | nullnoThe filing the details as filed come from. Null when SEC Blast has no filing for the CIK.
as_of.accessionstringno
as_of.filing_datedate (YYYY-MM-DD)no
as_of.rolestringno
cikstringno
currentEntityCurrentno
datanullnoPresent, as null, only in the short {cik, data, snapshot} body.
filingsintegernoFilings in SEC Blast that name the company or person.
first_filing_datedate (YYYY-MM-DD) | nullno
fiscal_year_endstring | nullno
former_namesarray of objectno
irs_numberstring | nullno
last_filing_datedate (YYYY-MM-DD) | nullno
linksobjectno
links.filingsstringno
links.sec_filingsstringno
links.selfstringno
namestring | nullno
role_countsobjectno
rolesarray of stringno
sicstring | nullno
snapshotSnapshotno
spacSpacno
state_of_incstring | nullno

Example request

Python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/entities/AAPL",
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

Example answer

Python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/entities/AAPL",
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())
JSON
{
  "addresses": {
    "business": {
      "city": "CUPERTINO",
      "phone": "(408) 996-1010",
      "state": "CA",
      "street1": "ONE APPLE PARK WAY",
      "zip": "95014"
    },
    "mail": {
      "city": "CUPERTINO",
      "state": "CA",
      "street1": "ONE APPLE PARK WAY",
      "zip": "95014"
    }
  },
  "as_of": {
    "accession": "0001921094-26-001188",
    "filing_date": "2026-11-16",
    "role": "subject"
  },
  "cik": "0000320193",
  "current": {
    "addresses": {
      "business": {
        "city": "CUPERTINO",
        "state": "CA",
        "street1": "ONE APPLE PARK WAY",
        "zip": "95014"
      },
      "mail": {
        "city": "CUPERTINO",
        "state": "CA",
        "street1": "ONE APPLE PARK WAY",
        "zip": "95014"
      }
    },
    "category": "Large accelerated filer",
    "cik": "0000320193",
    "ein": "942404110",
    "entity_type": "operating",
    "exchanges": [
      "Nasdaq"
    ],
    "filings": 2281,
    "first_filing_date": "1994-01-26",
    "fiscal_year_end": "0925",
    "flags": null,
    "former_names": [
      {
        "from": "2007-01-10",
        "name": "APPLE INC",
        "to": "2019-08-05"
      },
      {
        "from": "1994-01-26",
        "name": "APPLE COMPUTER INC",
        "to": "2007-01-04"
      }
    ],
    "last_filing_date": "2026-11-16",
    "lei": null,
    "listed": [
      {
        "exchange": "Nasdaq",
        "ticker": "AAPL"
      }
    ],
    "listed_as_of": "2026-11-18",
    "name": "Apple Inc.",
    "phone": "(408) 996-1010",
    "sic": "3571",
    "sic_description": "Electronic Computers",
    "state_of_inc": "CA",
    "ticker_exchanges": [
      {
        "exchange": "Nasdaq",
        "ticker": "AAPL"
      }
    ],
    "tickers": [
      "AAPL"
    ]
  },
  "filings": 2283,
  "first_filing_date": "1994-01-26",
  "fiscal_year_end": "0925",
  "former_names": [
    {
      "date_changed": "2007-01-09",
      "name": "APPLE INC"
    },
    {
      "date_changed": "1997-08-08",
      "name": "APPLE COMPUTER INC"
    }
  ],
  "irs_number": "942404110",
  "last_filing_date": "2026-11-16",
  "links": {
    "filings": "/v3/filings?cik=0000320193",
    "sec_filings": "/v3/entities/0000320193/filings",
    "self": "/v3/entities/0000320193"
  },
  "name": "Apple Inc.",
  "role_counts": {
    "filed_by": 42,
    "filed_for": 30,
    "filer": 617,
    "issuer": 1409,
    "subject": 220
  },
  "roles": [
    "issuer",
    "filer"
  ],
  "sic": "3571",
  "snapshot": {
    "available": true,
    "date": "2026-11-18"
  },
  "spac": {
    "basis": "none",
    "computed_at": null,
    "current_name": null,
    "derive_version": null,
    "flags": [],
    "ipo_accession": null,
    "ipo_at": null,
    "merger_accession": null,
    "merger_closed_at": null,
    "sic_history_source": null,
    "spac_name": null,
    "status": "none"
  },
  "state_of_inc": "CA",
  "resolved": {
    "cik": "0000320193",
    "ticker": "AAPL",
    "ticker_file_date": "2026-11-18"
  }
}

More in Entities

Previous: GET /v3/entities · Next: GET /v3/entities/{cik_or_ticker}/filings

Markdown version: /docs/reference/get-entities-cik-or-ticker.md