---
title: "Get Company Count"
method: POST
path: "/api/v1/companies/count"
---

# Get Company Count

`POST /api/v1/companies/count`

## Request

- Base URL: `https://api.dropleads.io`
- URL: `https://api.dropleads.io/api/v1/companies/count`
- Auth: API key in header `X-API-Key`

Get the total number of companies matching filters.
**Does not consume credits**.

## Headers

- `Content-Type` string, required

## Request body

- object
  - `filters` object: All fields optional. Combined with AND.
    - `companyNames` string[]
    - `companyDomains` string[]
    - `linkedinUrls` string[]
    - `industries` string[]
    - `industriesExclude` string[]
    - `keywords` string[]
    - `keywordsExclude` string[]
    - `technologies` string[]
    - `technologiesExclude` string[]
    - `employeeRanges` string[]
    - `customEmployeeRange` object
      - `min` integer
      - `max` integer
    - `revenueRange` object
      - `min` number, nullable
      - `max` number, nullable
    - `fundingRange` object
      - `min` number, nullable
      - `max` number, nullable
    - `foundedYear` object
      - `min` integer, nullable
      - `max` integer, nullable
    - `countries` object
      - `include` string[]
      - `exclude` string[]
    - `states` object
      - `include` string[]
      - `exclude` string[]
    - `cities` object
      - `include` string[]
      - `exclude` string[]
    - `regions` object: Expands to countries.
      - `include` string[]
      - `exclude` string[]
    - `lists` object
      - `type` 'include' | 'exclude'
      - `listIds` string[]

## Response `200`

Successful response

- object
  - `success` boolean
  - `count` integer

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Insufficient credits
- `404`: Not found

---

[API](https://skmtc.dev/dropleads/apis/data-enrichment.md) - [All operations](https://skmtc.dev/dropleads/apis/data-enrichment/llms.txt) - [OpenAPI document](https://skmtc.dev/dropleads/apis/data-enrichment/revisions/293a8d3add39?raw)