# GET /v3/entities

Entity search. With q: SEC's snapshot is searched by current and former name, ticker and CIK (snapshot.available=true). When the snapshot store is unavailable: names as filed containing q, or CIKs starting with q. Without q: the most active entities as filed. Those two answers come from v3's own filings and look only at filings filed in the 30 days up to the newest filing date in v3 (most active = named by most filings of those days); an entity seen only in older filings is not listed. filings is always the entity's whole count in v3.

**API key:** required. See [Authentication](https://www.secblast.com/docs/authentication).

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

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `q` | query | string | no |   | Name, ticker or CIK. Omit to list the most active entities as filed (of the last 30 days of filings). |
| `limit` | query | integer | no | `20` | Maximum results, 1..50. |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [EntityList](https://www.secblast.com/docs/reference/schemas#schema-entitylist) (`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). |
| `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 [EntityList](https://www.secblast.com/docs/reference/schemas#schema-entitylist) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | array of [EntityMatch](https://www.secblast.com/docs/reference/schemas#schema-entitymatch) | yes |   |
| `has_more` | boolean | no |   |
| `next_cursor` | string \| null | no |   |
| `snapshot` | [Snapshot](https://www.secblast.com/docs/reference/schemas#schema-snapshot) | yes | available is true when the snapshot was searched; false when the list is names as filed. |

## Example request

```bash
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/entities'
```

[Open this route in the console](https://www.secblast.com/console#get-v3-entities)

## More in Entities

Previous: [`GET /v3/companies`](https://www.secblast.com/docs/reference/get-companies) · Next: [`GET /v3/entities/{cik}`](https://www.secblast.com/docs/reference/get-entities-cik)
