Skip to content

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.

Group: Entities

Parameters

NameInTypeRequiredDefaultDescription
qquerystringnoName, ticker or CIK. Omit to list the most active entities as filed (of the last 30 days of filings).
limitqueryintegerno20Maximum results, 1..50.

Responses

StatusBodyDescription
200EntityList (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).
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 EntityList object.

FieldTypeRequiredDescription
dataarray of EntityMatchyes
has_morebooleanno
next_cursorstring | nullno
snapshotSnapshotyesavailable is true when the snapshot was searched; false when the list is names as filed.

Example request

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

Open this route in the console

More in Entities

Previous: GET /v3/companies · Next: GET /v3/entities/{cik}

Markdown version: /docs/reference/get-entities.md