---
title: "Enrich a company by domain"
method: GET
path: "/leads/company-enrich"
tags: ["Leads"]
---

# Enrich a company by domain

`GET /leads/company-enrich`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/leads/company-enrich`
- Auth: API key in header `Authorization`

Returns firmographic details for a company from its domain — name, description, industry, size, location and social profiles. Backed by Hunter.io. Costs 7 credits per call.

## Query parameters

- `domain` string, required

## Response `200`

Enriched company data

- object
  - `object` 'lead_company_enrichment'
  - `found` boolean, nullable: False when Hunter has no match for the domain.
  - `domain` string, nullable
  - `name` string, nullable
  - `legal_name` string, nullable
  - `description` string, nullable
  - `industry` string, nullable
  - `sector` string, nullable
  - `employees` union: Employee count or range (e.g. "10K-50K").
    - string
    - integer
  - `founded_year` integer, nullable
  - `country` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `social` object
    - `linkedin` string, nullable
    - `twitter` string, nullable
    - `facebook` string, nullable

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `402`: Insufficient credits
- `422`: Validation error
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error
- `502`: Upstream (provider) failure

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)