Skip to content
Searches page titles, headings, and route paths. Press slash to focus.

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

string

This route needs an API key. Sign in to send it with yours; a free account comes with a key.

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

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"
  }
}

Parameters

NameInTypeRequiredDescription
cik_or_tickerin pathstringyesrequiredThe company's CIK, such as 320193 (leading zeros optional), or its ticker, such as AAPL (any letter case, from SEC's ticker file). An unknown ticker is a 400 unknown_ticker error; the resolved member gives the CIK.

Response body

A successful answer (200) is an Entity object.

FieldTypeAlways presentDescription
addressesAddressesnoThe addresses in the latest filing; both are null when SEC Blast has no filing for the CIK. Present only in the full body.
as_ofobject | nullnoThe filing the details as filed come from. Null when SEC Blast has no filing for the CIK. Present only in the full body.
as_of.accessionstringyesalways presentThat filing's accession number.
as_of.filing_datedate (YYYY-MM-DD)yesalways presentThe date SEC assigned to that filing. Calendar date YYYY-MM-DD, in US Eastern time.
as_of.rolestringyesalways presentThe part the company or person plays in that filing, such as filer.
cikstringyesalways presentThe 10-digit CIK.
currentEntityCurrentnoSEC's current record for the CIK. Present only in the full body.
datanullnoAlways null. Present only in the short body.
filingsintegernoNumber of filings in SEC Blast that name the company or person. Present only in the full body.
first_filing_datedate (YYYY-MM-DD) | nullnoThe earliest such filing's date. Calendar date YYYY-MM-DD, in US Eastern time. Null when there is none. Present only in the full body.
fiscal_year_endstring | nullnoThe fiscal year end in the latest filing: month and day as MMDD, such as 0928. Null when it gives none. Present only in the full body.
former_namesarray of objectnoEarlier names in the latest filing's header. Present only in the full body.
former_names[].date_changedstringyesalways presentWhen the name changed. Calendar date YYYY-MM-DD, such as 2019-04-15, or an empty string when the header gives no valid date.
former_names[].namestringyesalways presentThe earlier name, as filed.
irs_numberstring | nullnoThe IRS employer identification number in the latest filing. Null when it gives none. Present only in the full body.
last_filing_datedate (YYYY-MM-DD) | nullnoThe latest such filing's date. Calendar date YYYY-MM-DD, in US Eastern time. Null when there is none. Present only in the full body.
linksobjectnoPaths of related resources in this API. Present only in the full body.
links.filingsstringyesalways presentThe path of SEC Blast's filings that name the CIK.
links.sec_filingsstringyesalways presentThe path of SEC's own filing list for the CIK.
links.selfstringyesalways presentThe path of this record.
namestring | nullnoThe latest name as filed, else SEC's current name. Null when neither is known. Present only in the full body.
role_countsobjectnoNumber of filings per role: each key is a role, as FilingEntity's role. Present only in the full body.
role_counts.<key>integernoNumber of filings in which the company or person has this role.
rolesarray of stringnoEvery role the company or person has in SEC Blast's filings. Present only in the full body.
sicstring | nullnoThe SIC (Standard Industrial Classification) code in the latest filing: SEC's four-digit industry code. Null when it gives none. Present only in the full body.
snapshotSnapshotyesalways presentWhether SEC's nightly company data answered for this record.
spacSpacyesalways presentWhether the company is or was a SPAC; status none when no filing shows SIC 6770.
state_of_incstring | nullnoThe state of incorporation in the latest filing. Null when it gives none. Present only in the full body.

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

StatusBodyMeaning
200Entity (application/json)OK
404Problem (application/problem+json)Not found.

Like every route, it can also answer with an error: 400, 401, 503, or another status. See Errors.

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