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

# Create an enrichment

> Enrich supplied businesses by company name and website without running a Maps search.

Creates an asynchronous enrichment job for businesses you already have. It does not run Google Maps discovery. Every submitted business appears immediately in the Mapsdata dashboard while contact discovery and verification continue.

<ParamField header="Idempotency-Key" type="string" required>
  A stable unique value for one logical enrichment batch. Required in production. Retry the same body with the same value after a timeout.
</ParamField>

<ParamField body="name" type="string">
  Dashboard list name, up to 200 characters. Defaults to `Enrich {count} supplied businesses`.
</ParamField>

<ParamField body="businesses" type="array" required>
  Between 1 and 700 unique businesses, further bounded by the account plan and available credits.

  <Expandable title="business fields">
    <ParamField body="businesses[].business_name" type="string" required>The company or business name, up to 200 characters.</ParamField>
    <ParamField body="businesses[].website_url" type="string" required>An absolute `http://` or `https://` company website URL.</ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://www.mapsdata.io/api/v1/enrichments" \
    -H "Content-Type: application/json" \
    -H "x-api-key: md_live_your_key" \
    -H "Idempotency-Key: october-plumbing-enrichment-v1" \
    -d '{
      "name": "Plumbing companies to enrich",
      "businesses": [
        {
          "business_name": "Plumbing NYC",
          "website_url": "https://www.plumbingnyc.com"
        },
        {
          "business_name": "A&E NYC Plumbing",
          "website_url": "https://www.aeplumbingnyc.com"
        }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 202 theme={null}
  {
    "job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
    "status": "enriching",
    "businesses_submitted": 2,
    "credits_reserved": 2,
    "message": "Enrichment accepted. It is visible in your Mapsdata dashboard."
  }
  ```
</ResponseExample>

## What runs

Mapsdata uses the supplied website as the starting point for contact discovery, owner and decision-maker research, social discovery, additional public-source matching, and email verification where data is available. The job begins in `enriching` because business discovery has already been supplied by the caller.

## Validation and credits

* Duplicate name and website pairs are rejected with `422`.
* Relative URLs and non-HTTP(S) URLs are rejected with `422`.
* Active paid plans reserve one credit per submitted business.
* The free plan uses the same single 100-credit free-job rules as a search.
* Requests beyond the plan maximum or available balance are rejected before a job or lead is created.
* The same body and idempotency key return the existing job without charging twice.

<div className="callout mint-my-5 mint-rounded-xl mint-border mint-border-[#656c2e]/30 mint-bg-[#656c2e]/10 mint-px-5 mint-py-4 mint-text-sm mint-text-[#4d5321]">
  Standalone enrichment jobs appear in the same Dashboard and Lead lists as searches, labelled <strong>Standalone enrichment · API</strong>. Lead fields update live while workers finish.
</div>


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