Reference for the live Clous Entities endpoint — a company / CIK / ticker directory for resolving any SEC filer to a canonical entity.

Entities

The entities endpoint is the company / CIK / ticker directory that powers entity resolution across Clous. Each record is a canonical SEC filer — resolved from public SEC EDGAR submissions — keyed by CIK and enriched with tickers, exchanges, SIC industry, entity type, and filing history.

Base URL: https://api.clous.ai
Auth: Authorization: Bearer clous_live_...

List / search entities

GET /v1/entities

List, search, and filter SEC entities. Results are returned through the standard envelope and are cursor-paginated.

Query parameters

Prop

Type

Example request

Search for entities matching "nvidia":

curl -s "https://api.clous.ai/v1/entities?q=nvidia&limit=2" \
  -H "Authorization: Bearer clous_live_..."

import requests

resp = requests.get(
    "https://api.clous.ai/v1/entities",
    params={"q": "nvidia", "limit": 2},
    headers={"Authorization": "Bearer clous_live_..."},
)
resp.raise_for_status()
data = resp.json()

const resp = await fetch(
  "https://api.clous.ai/v1/entities?q=nvidia&limit=2",
  {
    headers: { Authorization: "Bearer clous_live_..." },
  },
);
const data = await resp.json();

Example response

{
  "data": [
    {
      "cik": "1045810",
      "name": "NVIDIA CORP",
      "ticker": "NVDA",
      "tickers": "[\"NVDA\"]",
      "exchanges": "[\"Nasdaq\"]",
      "sic": "3674",
      "sic_description": "Semiconductors & Related Devices",
      "entity_type": "operating",
      "category": "Large accelerated filer",
      "state_of_incorp": "DE",
      "fiscal_year_end": "0131",
      "ein": "943177549",
      "filing_count": 1004,
      "former_names": "[{\"to\": \"2002-06-04T04:00:00.000Z\", \"from\": \"1998-05-07T04:00:00.000Z\", \"name\": \"NVIDIA CORP/CA\"}]",
      "observed_at": "2026-06-03T12:23:55"
    },
    {
      "cik": "2038014",
      "name": "INVIDIA CURIE FUND I-A LP",
      "ticker": null,
      "tickers": "[]",
      "exchanges": "[]",
      "sic": null,
      "sic_description": null,
      "entity_type": "other",
      "category": null,
      "state_of_incorp": "DE",
      "fiscal_year_end": "1231",
      "ein": "992029498",
      "filing_count": 2,
      "former_names": "[]",
      "observed_at": "2026-05-30T04:09:45"
    }
  ],
  "page": {
    "limit": 2,
    "next_cursor": "MnwyMDM4MDE0",
    "has_more": true
  },
  "as_of": "2026-06-12T04:10:30.334194Z",
  "source": "entities",
  "query_echo": {
    "q": "nvidia",
    "limit": 2
  },
  "warnings": []
}

tickers, exchanges, and former_names are returned as JSON-encoded strings — parse them client-side. ticker, sic, sic_description, and category are null for entities without that attribute (e.g. non-traded funds).

Status codes

Status	Meaning
`200`	Success. An empty result still returns `200` with `data: []` and a `warnings` entry.
`401`	Missing or invalid API key. See errors.
`402`	Out of credits. See errors.
`422`	Validation error — a parameter was the wrong type or out of range.
`429`	Rate limited. See rate limits.

Notes

Use cik for an exact single-entity lookup; it is the primary resolver. Zero-padding is not required — CIKs are stored as plain integer strings, e.g. "320193".
ticker is case-insensitive, but only ~8k publicly-traded entities carry one — most filers (funds, SPVs, individuals) resolve only by cik, q, or other filters.
For broad q name searches, results are ordered by filing_count DESC so the most prominent matching entity surfaces first.
entity_type values are lowercase: operating, investment, or other.
All data derives from public SEC EDGAR filings; Clous is independent of the SEC.
For paging through large result sets, follow page.next_cursor — see Pagination, Errors & Rate limits.

Entities

Entities

List / search entities

Query parameters

Example request

Example response

Status codes

Notes

On this page