> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/search/lead-enrichment/search-lead-locations.md).

# Search Lead Locations

Fuzzy-search the allowed contact\_location values used by Lead Enrichment. Free helper.

## Search Lead Locations

<mark style="color:green;">`POST`</mark> `/search_lead_locations`

{% hint style="info" %}
Free — no credits are used. Fuzzy-search the allowed `contact_location` values used by **Lead Enrichment**. This is distinct from the country *codes* used by Company Search.
{% endhint %}

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name      | Type   | Description                                 |
| --------- | ------ | ------------------------------------------- |
| `api_key` | string | Your API Key. Must resolve to a valid user. |
| `search`  | string | Text to match against location values.      |

**Response**

The rows are under `data`, one location string per row, ready to pass in `contact_location`. See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

`total` is the number of matches returned.

**Example**

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key",
  "search": "united"
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": ["united states", "united kingdom", "united arab emirates"],
  "credits_used": 0,
  "credits_remaining": 4823,
  "total": 3,
  "success": true
}
```

{% endtab %}
{% endtabs %}