# 04 bulk enrichment

\# Bulk Enrichment

\> Enrich hundreds of contacts at once — via the API or by uploading a CSV in the dashboard.

\## How it works

Submit a list of contacts with names and company domains. LeadSonar finds and verifies the best email and phone number for each person, then returns the enriched results.

Every contact is checked and verified in real time. You only pay for contacts where data is found.

\## Via API

Send up to 100 contacts per request:

\`\`\`bash curl -X POST <https://app.leadsonar.io/api/v1/enrich\\>
-H "Authorization: Bearer YOUR\_API\_KEY"\
-H "Content-Type: application/json"\
-d '{ "contacts": \[\
{ "firstName": "Sarah", "lastName": "Chen", "website": "figma.com" },\
{ "firstName": "Mike", "lastName": "Lee", "website": "linear.app" },\
{ "firstName": "Lisa", "lastName": "Park", "website": "vercel.com" }\
], "findEmail": true, "findPhone": false }' \`\`\`

The response contains a \`jobId\`. Poll \`GET /api/v1/enrich/:jobId\` until \`status\` is \`completed\`.

For lists larger than 100, split into batches and submit sequentially.

\## Via Dashboard

1\. Go to \*\*Enrichment\*\* in the sidebar 2. Upload a CSV with columns: \`first\_name\`, \`last\_name\`, \`website\` (or \`company\`) 3. Select what to find: email, phone, or both 4. Click \*\*Start Enrichment\*\* 5. Download the enriched CSV when complete

\## What you get back

For each contact, LeadSonar returns:

\| Field | Description | |-------|-------------| | email | Verified work email address | | phone | Direct-dial phone number (if requested) | | confidence | \`high\`, \`medium\`, or \`low\` | | emailStatus | Verification result: \`valid\`, \`catch-all\`, \`unknown\` |

\## Tips for best results

\- \*\*Use company domains\*\*, not company names, when possible — \`stripe.com\` works better than \`Stripe\` - \*\*Check your spelling\*\* — typos in names reduce match rates - \*\*Include both first and last name\*\* — partial names return fewer results - \*\*Start small\*\* — test with 10 contacts before running thousands

\## Credit usage

Each contact costs 1 credit per enrichment type: - Email only: 1 credit per contact - Phone only: 1 credit per contact - Email + phone: 2 credits per contact

Contacts where no data is found are not charged.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://scalingroom.gitbook.io/leadsonar-docs/04-bulk-enrichment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.