# 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](https://www.secblast.com/docs/authentication).

**Group:** [Entities](https://www.secblast.com/docs/reference#entities)

## Try it

Send this route from the page, signed in with your key, or from the [console](https://www.secblast.com/console).

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `cik_or_ticker` | path | string | yes |   | 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. |

## 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

| Status | Body | Description |
|---|---|---|
| `200` | [Entity](https://www.secblast.com/docs/reference/schemas#schema-entity) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`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). |
| `404` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Not found. |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [Entity](https://www.secblast.com/docs/reference/schemas#schema-entity) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `addresses` | [Addresses](https://www.secblast.com/docs/reference/schemas#schema-addresses) | no |   |
| `as_of` | object \| null | no | The filing the details as filed come from. Null when SEC Blast has no filing for the CIK. |
| `as_of.accession` | string | no |   |
| `as_of.filing_date` | date (YYYY-MM-DD) | no |   |
| `as_of.role` | string | no |   |
| `cik` | string | no |   |
| `current` | [EntityCurrent](https://www.secblast.com/docs/reference/schemas#schema-entitycurrent) | no |   |
| `data` | null | no | Present, as null, only in the short {cik, data, snapshot} body. |
| `filings` | integer | no | Filings in SEC Blast that name the company or person. |
| `first_filing_date` | date (YYYY-MM-DD) \| null | no |   |
| `fiscal_year_end` | string \| null | no |   |
| `former_names` | array of object | no |   |
| `irs_number` | string \| null | no |   |
| `last_filing_date` | date (YYYY-MM-DD) \| null | no |   |
| `links` | object | no |   |
| `links.filings` | string | no |   |
| `links.sec_filings` | string | no |   |
| `links.self` | string | no |   |
| `name` | string \| null | no |   |
| `role_counts` | object | no |   |
| `roles` | array of string | no |   |
| `sic` | string \| null | no |   |
| `snapshot` | [Snapshot](https://www.secblast.com/docs/reference/schemas#schema-snapshot) | no |   |
| `spac` | [Spac](https://www.secblast.com/docs/reference/schemas#schema-spac) | no |   |
| `state_of_inc` | string \| null | no |   |

## 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`](https://www.secblast.com/docs/reference/get-entities) · Next: [`GET /v3/entities/{cik_or_ticker}/filings`](https://www.secblast.com/docs/reference/get-entities-cik-or-ticker-filings)
