> 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/icp-enrichment/list-enrichments.md).

# List Enrichments

List your ICP enrichment jobs.

## List Enrichments

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

{% hint style="info" %}
Free — no credits are charged.
{% endhint %}

**Headers**

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

**Body**

| Name       | Type    | Description                                |
| ---------- | ------- | ------------------------------------------ |
| `api_key`  | string  | Your API Key.                              |
| `listname` | string  | Optional. Filter jobs to this list.        |
| `limit`    | integer | Optional. Max jobs to return (default 50). |

**Response**

| Field in each row      | Type   | Description                                                           |
| ---------------------- | ------ | --------------------------------------------------------------------- |
| `job_id`               | string | The job handle. Pass it to Get Enrichment.                            |
| `status`               | string | `queued`, `processing`, `done`, `not_found`, `cancelled`, or `error`. |
| `view`                 | string | Which list view was scored, `verified` or `all`.                      |
| `icp_id`               | number | The ICP scored against.                                               |
| `icp_name`             | string | That ICP's name.                                                      |
| `list_name`            | string | The list scored, or a note when contacts were sent inline.            |
| `total`                | number | Contacts in the job.                                                  |
| `passed_deterministic` | number | Contacts that cleared the filters.                                    |
| `matched`              | number | Contacts that scored at or above the threshold.                       |
| `threshold`            | number | Match cutoff used for the run.                                        |
| `created_at`           | string | When the job was created.                                             |

The jobs are under `data`, and the top-level `total` is how many jobs came back. See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

**Example**

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

```json
{
  "api_key": "your_api_key",
  "limit": 50
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": [
    {
      "icp_id": 26,
      "icp_name": "Sales Director Small Company",
      "list_name": "(inline: 2 contacts)",
      "status": "done",
      "total": 2,
      "passed_deterministic": 1,
      "matched": 0,
      "threshold": 0.75,
      "created_at": "2026-07-22T23:35:21Z",
      "job_id": "011709e1-8310-429c-8e7a-34533670ec25",
      "view": "verified"
    }
  ],
  "total": 1,
  "credits_used": 0,
  "credits_remaining": 4004.8,
  "success": true
}
```

{% endtab %}
{% endtabs %}