---
title: "Company Enrichment API Reference | Leadsets Docs"
description: "POST /v1/companies/enrich: industry, NAICS, headcount, revenue range, location and technologies from a domain. 1 enrichment record when found."
canonical: https://www.leadsets.ai/docs/api/companies-enrich
updated: 2026-11-11
---

REST API / Companies

# Enrich a company

A company profile from its domain: industry, NAICS, headcount, revenue range, location, founded year, description and technologies, with a last-seen date and confidence on every field.

POST /v1/companies/enrich MCP: enrich_company

Records

1 when found

Meters

enrichment records + requests / 5 hrs, records / week

Not found

0 records · 1 request

## Body parameters

domain string

Domain or website URL, e.g. "northwind.io" or "https://www.northwind.io/pricing".

linkedin_url string

A linkedin.com/company/… URL, when you have no domain.

prompt string

Optional. The request in plain language, up to 1,000 characters. Stored with the call in your request log.

Send `domain` or `linkedin_url`. If you send both, `domain` is used.

## Response

`company` with `company_id`, `name`, `domain`, `linkedin_url`, `industry`, `naics`, `employees`, `employee_range`, `revenue_range`, `location`, `founded_year`, `description`, `technologies`, freshness (`refreshed_at`, `confirmed_at`, `stale_after_at`, `stale`) and `sources`, which gives the last-seen date and confidence of every returned field. Then `usage` and `request_id`.

To find people at the company next, pass its domain to [POST /v1/people/search](https://www.leadsets.ai/docs/api/people-search) as `company_domain`.

## Errors

| Status | type | Meaning |
| --- | --- | --- |
| `400` | `invalid_request` | A value isn't valid. The message names the field in `param`. |
| `401` | `unauthorized` | Missing, invalid, expired or revoked key. See [Authentication](https://www.leadsets.ai/docs/authentication). |
| `402` | `free_records_exhausted` | Free plan: the 1,000 free enrichment records or the 1,000 free data calls are used up. |
| `403` | `forbidden` | The key is read only. Data tools need a key with data access. |
| `404` | `not_found` | No company found for that input. Nothing was counted. |
| `429` | `window_full` | A five-hour records or requests window is full. See Retry-After and `resets_at`. |
| `429` | `weekly_limit` | The seven-day records limit is reached. Resume after `resets_at`. |

[Previous
**← enrich_person**](https://www.leadsets.ai/docs/api/people-enrich) [Next
**verify_email →**](https://www.leadsets.ai/docs/api/emails-verify)

Was this page useful? [Tell us](mailto:support@leadsets.ai?subject=Docs%20feedback%3A%20%2Fdocs%2Fapi%2Fcompanies-enrich)

```bash
curl https://api.leadsets.ai/v1/companies/enrich \
 -H "Authorization: Bearer $LEADSETS_KEY" \
 -H "Content-Type: application/json" \
 -H "Idempotency-Key: 1f7b…" \
 -d '{
   "domain": "northwind.io"
 }'
```

```ts
import { Leadsets } from "@leadsetsai/sdk";

const ls = new Leadsets(process.env.LEADSETS_KEY);
const res = await ls.companies.enrich({
 domain: "northwind.io",
});
```

```python
import os
from leadsets import Leadsets

ls = Leadsets(os.environ["LEADSETS_KEY"])
res = ls.companies.enrich(
   domain="northwind.io",
)
```

Response 200 OK

```
{
 "company": {
   "company_id": "8c1f0b7a-52d4-4c3e-9e61-2a7d5f0c9b48",
   "name": "Northwind Analytics",
   "domain": "northwind.io",
   "linkedin_url": "https://www.linkedin.com/company/northwind-analytics",
   "industry": "SaaS",
   "naics": "518210",
   "employees": 120, "employee_range": "51-200",
   "revenue_range": "10M-50M",
   "location": { "country": "US", "region": "CA", "city": "San Francisco" },
   "founded_year": 2017,
   "description": "Product analytics for B2B teams.",
   "technologies": ["hubspot", "segment", "stripe"],
   "refreshed_at": "2026-11-01T00:00:00Z", "stale": false,
   "sources": { "employees": { "seen_at": "2026-11-01T00:00:00Z",
                               "confidence": 0.9 } }
 },
 "usage": { "enrich_records_counted": 1, "enrich_records_left_5h": 14999,
            "enrich_requests_left_5h": 74999, "enrich_records_left_week": 74999 },
 "request_id": "req_2c9e7d1a5b40"
}
```

---

Leadsets by Mobylogix LLC, 10160 hwy 242, Conroe, TX, 77385, US. Facts for AI assistants: https://www.leadsets.ai/llm · Site index: https://www.leadsets.ai/llms.txt · Every page: https://www.leadsets.ai/llms-full.txt