> 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/enrichments/linkedin-profile-url-finder/list-lookup.md).

# List Lookup

Resolve a LinkedIn profile URL for every contact in a Parvenu list. Asynchronous, writes results back into the list.

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

{% hint style="info" %}
This is an **asynchronous** endpoint. It returns a job acknowledgement, not data. Poll `/check_list_status` until the list reports `done`, then fetch the rows with `/download_list`. Costs **0.5 credits per row**, charged only when a profile is found. Results are written to the `person_linkedin_url` column.
{% endhint %}

{% hint style="warning" %}
This endpoint does not accept a `state` filter, unlike Headcount and Personal Email. Passing `state` returns a 400 (`Extra inputs are not permitted`). It processes every row in the list, unless you send `saved_view`.
{% endhint %}

Use this to resolve URLs for every contact in a list in one call, rather than looping over [Individual Lookup](/enrichments/linkedin-profile-url-finder/individual-lookup.md) per row.

**Headers**

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

**Body**

| Name         | Type   | Description                                                                                                                                 |
| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `api_key`    | string | Your API Key.                                                                                                                               |
| `listname`   | string | Name of the existing Parvenu list to enrich.                                                                                                |
| `saved_view` | string | Optional. Name of a saved view on this list. Runs only on the contacts in that view. Don't combine with `view`, `filter_stack` or `search`. |

**Saved views.** To run only on the contacts in a saved view, send its name as `saved_view`. See [List Saved Views](/manage-lists/list-saved-views.md).

**Example**

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

```json
{
  "api_key": "your_api_key",
  "listname": "my_list"
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "success": true,
  "job_id": "2aa89f93-ac88-4d84-9d8b-8814bdfc9eee",
  "status": "queued",
  "list_name": "my_list",
  "rows_selected": 10,
  "rows_fetched": 10,
  "message": "queued",
  "view": "all",
  "max_rows": 5000,
  "truncated": false,
  "credits_used": 0
}
```

{% endtab %}

{% tab title="Error" %}

```json
{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "state: Extra inputs are not permitted"
  },
  "success": false
}
```

{% endtab %}
{% endtabs %}

**Reading the acknowledgement**

| Field           | Meaning                                                                            |
| --------------- | ---------------------------------------------------------------------------------- |
| `job_id`        | Identifier for this run. Always a string.                                          |
| `status`        | A job status: `queued`, `processing`, `done`, `not_found`, `cancelled` or `error`. |
| `rows_selected` | How many rows matched before the page limit was applied.                           |
| `rows_fetched`  | How many rows this run actually picked up. This is the number that gets processed. |
| `max_rows`      | The ceiling a single run will fetch.                                               |
| `truncated`     | `true` when the list was longer than `max_rows` and the run was cut to fit.        |

**Retrieving results**

* [Check List Status](/get-enrichment-results/check-list-status.md)
* [Download List Data](/get-enrichment-results/download-list-data.md)