---
updatedAt: 2026-09-08T13:36:55.000Z
agentTools:
  projectIndex: https://docs.cognism.com/llms.txt
---

# Endpoints

Every Cognism API operation, what it returns, and what it costs in rate-limit, search-token and credit terms.

All endpoints are relative to `https://api.cognism.com` and require a bearer token (see [Authentication](https://docs.cognism.com/docs/authentication)). The tables below list every operation, link to its reference page, and show which quota each one draws on — see [Rate limits](https://docs.cognism.com/docs/rate-limits) and [Credits and search tokens](https://docs.cognism.com/docs/credits-and-search-tokens) for how those quotas work.

## Search and count

| Method | Endpoint                                               | Purpose                                                           | Rate-limit operation | Search tokens         | Credits                                      |
| :----- | :----------------------------------------------------- | :---------------------------------------------------------------- | :------------------- | :-------------------- | :------------------------------------------- |
| `POST` | [`/persons/filter`](https://docs.cognism.com/reference/searchpersons)          | Search people. Returns one page of person records.                | `search`             | 1 per record returned | 1 per record when `view` includes `contacts` |
| `POST` | [`/persons/filter/count`](https://docs.cognism.com/reference/countpersons)     | Count people matching a filter. Returns `{ "total": n }` only.    | `count`              | —                     | —                                            |
| `POST` | [`/companies/filter`](https://docs.cognism.com/reference/searchcompanies)      | Search companies. Returns one page of company records.            | `search`             | 1 per record returned | —                                            |
| `POST` | [`/companies/filter/count`](https://docs.cognism.com/reference/countcompanies) | Count companies matching a filter. Returns `{ "total": n }` only. | `count`              | —                     | —                                            |

Search and count endpoints accept the same filter body, so you can count first and search only when the result set is the size you expect.

## Dictionaries

Dictionaries return the exact values that filters accept. Resolve free-text input (an industry name, a country, a seniority) against a dictionary before you put it in a filter.

| Method | Endpoint                                                             | Returns                                                                                                     | Query parameters                                                                                 |
| :----- | :------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- |
| `GET`  | [`/dictionaries/industries`](https://docs.cognism.com/reference/getindustries)               | Industry taxonomy (three levels, `parentId` links a child to its parent).                                   | `id`, `name`, `level`, `parentId`                                                                |
| `GET`  | [`/dictionaries/industry_codes`](https://docs.cognism.com/reference/getindustrycodes)        | SIC, NAICS and ISIC codes mapped to industries. Paginated.                                                  | `classification` (`sic` \| `naics` \| `isic`), `code`, `industryId`, `limit`, `cursor`, `offset` |
| `GET`  | [`/dictionaries/regions`](https://docs.cognism.com/reference/getregions)                     | Geographic regions (Africa, Americas, Asia, Europe, Oceania).                                               | —                                                                                                |
| `GET`  | [`/dictionaries/countries`](https://docs.cognism.com/reference/getcountries)                 | Countries with their region.                                                                                | `name`, `regionId`                                                                               |
| `GET`  | [`/dictionaries/departments`](https://docs.cognism.com/reference/getdepartments)             | Departments used in person and hiring-event filters.                                                        | —                                                                                                |
| `GET`  | [`/dictionaries/seniorities`](https://docs.cognism.com/reference/getseniorities)             | Seniority levels: C-Suite, Vice President, Director, Manager, Individual Contributor.                       | —                                                                                                |
| `GET`  | [`/dictionaries/technologies`](https://docs.cognism.com/reference/gettechnologies)           | Technologies detected on company records. Paginated.                                                        | `name`, `limit`, `cursor`, `offset`                                                              |
| `GET`  | [`/dictionaries/intent-topics`](https://docs.cognism.com/reference/getintenttopicscatalogue) | Intent topic catalogue. **Returns an empty list in v1**; parameters are accepted for forward compatibility. | `name`, `limit`, `cursor`, `offset`                                                              |

Dictionary requests count against the `dictionary` rate-limit operation and cost no search tokens or credits.

## Account settings

| Method | Endpoint                                                             | Returns                                                                                                        |
| :----- | :------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------- |
| `GET`  | [`/intent/topics`](https://docs.cognism.com/reference/getintenttopics)                       | The intent topic IDs selected for your account and the maximum number of topics the account may configure.     |
| `GET`  | [`/settings/compliance`](https://docs.cognism.com/reference/getcompliancesettings)           | Countries where phone numbers are masked (do-not-call) and geo-restrictions excluded from your search results. |
| `GET`  | [`/settings/personalization`](https://docs.cognism.com/reference/getpersonalizationsettings) | Your account's selected intent topics and watched technologies.                                                |
| `GET`  | `/settings/billing`                                                  | Search tokens remaining, allotment and reset time; credit allotment and reset time.                            |

Settings requests cost no search tokens or credits.

## Health

| Method | Endpoint  | Returns                                   |
| :----- | :-------- | :---------------------------------------- |
| `GET`  | `/health` | Service health probe. Never rate limited. |