---
title: "Enrich Companies"
method: POST
path: "/api/v1/companies/enrich"
---

# Enrich Companies

`POST /api/v1/companies/enrich`

## Request

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

Enrich companies by domain and/or company name - returns the full company record for each match. Not-found domains/names are returned separately and are never charged.**Deducts 0.1 credit per company actually found** (max 50 domains + names combined per request).

## Headers

- `Content-Type` string, required

## Request body

- object: At least one of `domains` or `companyNames` is required.
  - `domains` string[]
  - `companyNames` string[]

## Response `200`

Successful response

- object
  - `success` boolean
  - `data` object
    - `companies` object[]
      - `id` string: Primary domain, used as the unique company key.
      - `name` string
      - `domain` string
      - `websiteUrl` string
      - `linkedinUrl` string
      - `industry` string
      - `keywords` string, nullable
      - `employees` integer, nullable
      - `foundedYear` integer, nullable
      - `annualRevenue` number, nullable
      - `totalFunding` number, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `country` string, nullable
      - `phone` string, nullable
      - `technologyNames` string, nullable
    - `notFoundDomains` string[]
    - `notFoundNames` string[]
    - `totalRequested` integer
    - `totalFound` integer
  - `credits` object
    - `success` boolean
    - `creditsDeducted` number
    - `sourceUsed` 'subscription' | 'payg' | 'both' | 'none'

## 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)