GET / v3/ entities/ {cik_ or_ ticker}
On this page
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
This route needs an API key. Sign in to send it with yours; a free account comes with a key.
Response
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
{
"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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
cik_ | in path | string | yesrequired | The 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.
| Field | Type | Always present | Description |
|---|---|---|---|
addresses | Addresses | no | The addresses in the latest filing; both are null when SEC Blast has no filing for the CIK. Present only in the full body. |
as_ | object | null | no | The filing the details as filed come from. Null when SEC Blast has no filing for the CIK. Present only in the full body. |
as_ | string | yesalways present | That filing's accession number. |
as_ | date (YYYY-MM-DD) | yesalways present | The date SEC assigned to that filing. Calendar date YYYY-MM-DD, in US Eastern time. |
as_ | string | yesalways present | The part the company or person plays in that filing, such as filer. |
cik | string | yesalways present | The 10-digit CIK. |
current | EntityCurrent | no | SEC's current record for the CIK. Present only in the full body. |
data | null | no | Always null. Present only in the short body. |
filings | integer | no | Number of filings in SEC Blast that name the company or person. Present only in the full body. |
first_ | date (YYYY-MM-DD) | null | no | The 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_ | string | null | no | The 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_ | array of object | no | Earlier names in the latest filing's header. Present only in the full body. |
former_ | string | yesalways present | When 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_ | string | yesalways present | The earlier name, as filed. |
irs_ | string | null | no | The IRS employer identification number in the latest filing. Null when it gives none. Present only in the full body. |
last_ | date (YYYY-MM-DD) | null | no | The 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. |
links | object | no | Paths of related resources in this API. Present only in the full body. |
links. | string | yesalways present | The path of SEC Blast's filings that name the CIK. |
links. | string | yesalways present | The path of SEC's own filing list for the CIK. |
links. | string | yesalways present | The path of this record. |
name | string | null | no | The latest name as filed, else SEC's current name. Null when neither is known. Present only in the full body. |
role_ | object | no | Number of filings per role: each key is a role, as FilingEntity's role. Present only in the full body. |
role_ | integer | no | Number of filings in which the company or person has this role. |
roles | array of string | no | Every role the company or person has in SEC Blast's filings. Present only in the full body. |
sic | string | null | no | The 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. |
snapshot | Snapshot | yesalways present | Whether SEC's nightly company data answered for this record. |
spac | Spac | yesalways present | Whether the company is or was a SPAC; status none when no filing shows SIC 6770. |
state_ | string | null | no | The 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
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