# Company enrich

> Look up one company’s profile by domain, LinkedIn URL or name.

`company_enrich` looks up one company by its domain (best), LinkedIn company URL or name, and returns its profile: name, domain, description, industry, headcount, founding year, location and LinkedIn URL. Give one of `domain`, `linkedin_url` or `name`. To find companies you don’t know yet, use [`company_search`](https://clonvo.com/docs/company-search.md).

Call it with `POST /v1/tools/company_enrich`, or as `company_enrich` over [MCP](https://clonvo.com/docs/mcp.md). It runs on Clonvo credits only.

## Arguments

-   `domain` string
    
    The company’s website domain, e.g. stripe.com. Use a bare domain such as example.com (no scheme, path or wildcard).
    
-   `linkedin_url` string
    
    a LinkedIn company URL such as https://www.linkedin.com/company/stripe
    
-   `name` string
    
    The company’s name, when you have neither domain nor LinkedIn URL.
    

## Example

```bash
curl https://api.clonvo.com/v1/tools/company_enrich \
  -H "Authorization: Bearer $CLONVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "arguments": { "domain": "weaviate.io" } }'
```

```json
{
  "id": "gen-01M6A2F7H9K1M3P5R7T9V1X3Z5",
  "tool": "company_enrich",
  "provider": "clonvo",
  "result": {
    "company": {
      "name": "Weaviate",
      "domain": "weaviate.io",
      "website": "https://weaviate.io",
      "description": "Weaviate is an open-source, deployment-agnostic vector database platform…",
      "industry": null,
      "employees": "73",
      "location": "Amsterdam Netherlands",
      "founded": null,
      "linkedin_url": null
    }
  },
  "usage": { "cost": 0.0005, "charged": 0.00051, "is_byok": false }
}
```

## Result

| Field | Description |
| --- | --- |
| `company` | The company, with the [company fields](https://clonvo.com/docs/company-search.md#company-fields), or `null` when no provider knows it. |
| `notes` | Present when the provider handled an argument differently, or to say that no provider knew the company. |

The fields around `result` (`id`, `tool`, `provider`, `usage`) are the same for every tool; see [Calling tools](https://clonvo.com/docs/calling-tools.md#response).

## Notes

-   When no provider knows the company, `company` is `null` and `notes` says so. A lookup that finds nothing is an answer, not an error; see [Tool billing](https://clonvo.com/docs/tool-billing.md#on-clonvo-credits) for what it costs.
-   Clonvo never returns email addresses or phone numbers, even when a provider sends them.