> 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/get-enrichment-results/running-enrichments.md).

# Running Enrichments

See every enrichment running on a list right now, from any door.

## Running Enrichments

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

{% hint style="info" %}
This is **free**. No credits are charged.
{% endhint %}

Lists the enrichments going on a list right now, whether they were started from the leads table, the API, Claude or a Flow, with how far each has got. Each one has an `enrichment_id` you can pass to [Stop an Enrichment](/get-enrichment-results/stop-an-enrichment.md).

**Headers**

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

**Body**

| Name       | Type   | Description           |
| ---------- | ------ | --------------------- |
| `api_key`  | string | Your API Key.         |
| `listname` | string | The name of the list. |

**Response**

`data.running` has one entry per run. See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

| Field           | Description                                                                                                                         |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `enrichment_id` | The run's id. Pass it to `/stop_enrichment` to stop exactly this run.                                                               |
| `enrichment`    | The enrichment's name, for example `Find Company Website`.                                                                          |
| `status`        | `running`, `paused` (picks up again on its own after an update) or `waiting` (runs as another enrichment fills the field it needs). |
| `rows_done`     | Rows (or companies) done so far.                                                                                                    |
| `rows_total`    | Rows in the run, when known.                                                                                                        |
| `started_from`  | `Table`, `API`, `MCP` or `Flow`.                                                                                                    |
| `covers`        | Which contacts the run covers, for example `Whole list`.                                                                            |

**Example**

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

```json
{
  "api_key": "your_api_key",
  "listname": "Pest Control Owners"
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": {
    "list_name": "Pest Control Owners",
    "running": [
      {
        "enrichment_id": "ea4aa3cf-f5b5-4317-8344-e1482bcd3ba2",
        "enrichment": "Find Company Website",
        "status": "running",
        "rows_done": 9,
        "rows_total": 40,
        "started_from": "MCP",
        "covers": "Whole list"
      }
    ]
  },
  "credits_used": 0,
  "credits_remaining": 7626.1,
  "message": null,
  "success": true
}
```

{% endtab %}
{% endtabs %}
