> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Enrichment API

> Enrich a company domain, name or LinkedIn URL into a full firmographic profile with funding, technology and headcount data.

`POST /v1/data/companies/enrichment/run`

**Pricing:** $0.05 per companie ($52.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**domains** `string[]`

Company website domains to look up, without scheme or www, one call per domain.

Format e.g. `stripe.com`.

**names** `string[]`

Company names to look up when a domain is not available; less accurate for common names.

**linkedinUrls** `string[]`

Company LinkedIn profile URLs to look up.

Format e.g. `https://www.example.com`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/companies/enrichment/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "domains": [
      "calendly.com",
      "hashicorp.com",
      "personio.com"
    ]
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/companies/enrichment/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "domains": [
        "calendly.com",
        "hashicorp.com",
        "personio.com"
    ]
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/companies/enrichment/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "domains": [
    "calendly.com",
    "hashicorp.com",
    "personio.com"
  ]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one companie, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `domain` | Domain | text |
| `companyName` | Company Name | text |
| `website` | Website | url |
| `linkedinUrl` | Linkedin Url | url |
| `logo` | Logo | image |
| `description` | Description | text |
| `foundedYear` | Founded Year | integer |
| `employeeCount` | Employee Count | integer |
| `industry` | Industry | text |
| `secondaryIndustries` | Secondary Industries | array |
| `keywords` | Keywords | array |
| `sicCodes` | Sic Codes | array |
| `naicsCodes` | Naics Codes | array |
| `hqStreet` | Hq Street | text |
| `hqCity` | Hq City | text |
| `hqState` | Hq State | text |
| `hqCountry` | Hq Country | text |
| `hqPostalCode` | Hq Postal Code | text |
| `phone` | Phone | phone |
| `twitterUrl` | Twitter Url | url |
| `facebookUrl` | Facebook Url | url |
| `annualRevenue` | Annual Revenue | currency |
| `totalFunding` | Total Funding | currency |
| `latestFundingStage` | Latest Funding Stage | text |
| `latestFundingDate` | Latest Funding Date | date |
| `fundingEvents` | Funding Events | object\_array |
| `parentCompany` | Parent Company | object |
| `marketCap` | Market Cap | text |
| `technologies` | Technologies | object\_array |
| `subsidiaries` | Subsidiaries | object\_array |
| `subsidiaryCount` | Subsidiary Count | integer |
| `departmentHeadcount` | Department Headcount | object |
| `headcountGrowth6m` | Headcount Growth 6m | percentage |
| `headcountGrowth12m` | Headcount Growth 12m | percentage |
| `headcountGrowth24m` | Headcount Growth 24m | percentage |
| `retailLocationCount` | Retail Location Count | integer |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "companies/enrichment",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "latestFundingDate": "2021-01-01T00:00:00.000+00:00",
      "twitterUrl": "https://twitter.com/calendly",
      "logo": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/6a9184bac4f1c000013b50f6/picture",
      "annualRevenue": 144100000,
      "facebookUrl": "https://facebook.com/Calendly",
      "retailLocationCount": 0,
      "companyName": "Calendly",
      "headcountGrowth24m": -0.1176470588235294,
      "fundingEvents": [
        {
          "date": "2021-01-01T00:00:00.000+00:00",
          "type": "Series A",
          "investors": "OpenView Venture Partners, ICONIQ Capital",
          "amount": "350M",
          "currency": "$"
        },
        {
          "date": "2020-11-01T00:00:00.000+00:00",
          "type": "Seed",
          "investors": "OpenView Partners, Atlanta Ventures",
          "amount": "550K",
          "currency": "$"
        }
      ],
      "marketCap": null,
      "hqState": "Georgia",
      "industry": "information technology & services",
      "headcountGrowth6m": 0.02888086642599278,
      "foundedYear": 2013,
      "subsidiaries": [],
      "hqCountry": "United States",
      "subsidiaryCount": null,
      "linkedinUrl": "http://www.linkedin.com/company/calendly",
      "naicsCodes": [
        "54151",
        "513210"
      ],
      "totalFunding": 351100000,
      "domain": "calendly.com",
      "technologies": [
        {
          "name": "AI",
          "category": "AI and Machine Learning Platforms"
        },
        {
          "name": "AWS Trusted Advisor",
          "category": "Cloud Services"
        }
      ],
      "phone": null,
      "headcountGrowth12m": 0.04204753199268738,
      "hqCity": "Atlanta"
    }
  ]
}
```

## Related APIs

If you only have a company name and need its domain use [`companies/domain-lookup`](https://docs.mindcase.co/apis/companies/domain-lookup); for its tech stack use [`builtwith/techstack`](https://docs.mindcase.co/apis/builtwith/techstack); for the LinkedIn company page use [`linkedin/companies`](https://docs.mindcase.co/apis/linkedin/companies).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.