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

# Enrich companies and people

> Match up to 25 companies or people you already know in one request, and read each result's status, confidence and what it matched on.

[Try in Playground](https://tako.com/console/playground/enrich/company-enrich)

[`POST /v1/companies/enrich`](https://docs.tako.com/api-reference/companies-enrich) and [`POST /v1/people/enrich`](https://docs.tako.com/api-reference/people-enrich) match records you already know. Send up to 25 `items`. The response has one result per item, in the order you sent them, and one card that holds the matched records.

## Match companies

```bash theme={null}
curl -X POST https://tako.com/api/v1/companies/enrich \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "domain": "stripe.com" },
      { "name": "Anduril", "country": "US" }
    ]
  }'
```

Each item needs at least one of these:

| Field | How it matches |
| - | - |
| `domain` | The company's website, matched exactly. |
| `linkedin_url` | The company's LinkedIn page, matched exactly. |
| `name` | The company's name, matched by score. |

`city`, `region`, `country` and `industry` are hints for a name match. A hint ranks companies that fit it higher, and never excludes one.

## Match people

```bash theme={null}
curl -X POST https://tako.com/api/v1/people/enrich \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "linkedin_url": "https://www.linkedin.com/in/example" },
      { "name": "Jane Doe", "company_domain": "example.com", "title": "VP Sales" }
    ]
  }'
```

Each item needs at least one of these:

| Field | How it matches |
| - | - |
| `email` | An email address, matched exactly. |
| `phone` | A phone number with its country code, such as `+1 415 555 0100`, matched exactly. |
| `linkedin_url` | A LinkedIn profile URL (`linkedin.com/in/...`), matched exactly. |
| `name` | The person's name, matched by score. |

`company_domain`, `company_name` and `title` are hints for a name match.

## Read a result

| Field | What it holds |
| - | - |
| `status` | `matched`, `no_match` or `failed`. `no_match` is an answer, not an error. `failed` means the lookup failed: retry the item. |
| `match_id` | The matched record's id. Its profile is a row of the card. |
| `confidence` | `exact`, `high` or `ambiguous`. See below. |
| `matched_on` | The input that found the record: `domain`, `linkedin_url`, `email`, `phone` or `name`. |
| `alternates` | How many other records match nearly as well, up to 3. |
| `unresolved` | Inputs that named nothing, as `field=value`. |
| `failed` | Inputs whose lookup failed or timed out. Retry these; they aren't misses. |

`confidence` says how sure the match is:

* **`exact`**: a website, LinkedIn URL, email or phone named the record.
* **`high`**: the name match is well ahead of the next.
* **`ambiguous`**: other records match nearly as well, or a website or LinkedIn page names more than one company. Check the record before you rely on it, or add a hint and send the item again.

## The card

The card holds the matched records in request order. An item that didn't match has a result and no row. `card` is `null` when nothing matched.

See [Get the rows and reveal premium fields](https://docs.tako.com/documentation/integrating-tako/enrichment/overview.md#get-the-rows-and-reveal-premium-fields) for the rows, and [What a list holds](https://docs.tako.com/documentation/integrating-tako/enrichment/overview.md#what-a-list-holds) for the fields.

## Billing

An enrich request bills one request, whatever the number of items. A request with any answered item, including a `no_match`, returns `200` and is billed. A request in which every lookup failed returns `503` and isn't billed. See [Pricing](https://docs.tako.com/documentation/integrating-tako/enrichment/overview.md#pricing).


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