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

# Paired enrichment

> Match up to 10 name and company pairs, each on its own, with a credit budget you set.

## person\_enrich\_pairs

Enrich up to 10 people by **name and company domain**. Each pair is matched on its own, in order, so a name is never matched against the wrong company. A plain `person_search` with a list of names and a list of domains can cross-match them.

* **Preview by default.** A free sample of up to 10 candidates per pair, without contact details.
* **Paid calls need explicit approval:** `preview: false`, `authorize_paid: true` and a `credit_budget`. Each full candidate costs 1 credit.
* **No retries, no pagination, no broadened filters.** If a call fails part-way, the per-pair results say what happened. Check `account_usage` before trying again.

**pairs** `object[]` *required*

Up to 10 objects of `{ "full_name": "Jane Doe", "company_domain": "acme.com" }`, matched in order.

**preview** `boolean` (default: true)

`true` for a free sample; `false` for full records.

**authorize\_paid** `boolean`

Must be `true` for a paid call, after the user approves the spend.

**credit\_budget** `integer`

1–100. The most credits the call may spend. Required for paid calls.

**matches\_per\_pair** `integer` (default: 1)

Paid candidates per pair, 1–10, within the remaining budget.

> [!NOTE]
>
> One candidate is not proof of a unique identity match. Check the name, title and company before using a record.


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