> 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/stop-an-enrichment.md).

# Stop an Enrichment

Stop an enrichment that is running on a list. Nothing more is looked up or charged.

## Stop an Enrichment

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

{% hint style="info" %}
This is **free**. No credits are charged for the call, and the stopped run charges nothing more.
{% endhint %}

Stops a run within a few seconds. The row it is on finishes and is charged as usual. No other row is looked up or charged, and rows it never reached get no log line. Rows already done keep their results and their charges. A stopped run cannot be resumed: start the enrichment again to carry on.

Works on any run on the list, wherever it was started: the leads table, the API, Claude, a run waiting for another enrichment, or a Flow run that writes to the list.

**Headers**

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

**Body**

| Name            | Type   | Description                                                                                                                      |
| --------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------- |
| `api_key`       | string | Your API Key.                                                                                                                    |
| `listname`      | string | The name of the list the enrichment runs on.                                                                                     |
| `enrichment_id` | string | Optional. The id of one run, from [Running Enrichments](/get-enrichment-results/running-enrichments.md). Stops exactly that run. |
| `enrichment`    | string | Optional. Or the enrichment's name, for example `Find Company Website` or `website`. Stops every run of it on the list.          |

With neither `enrichment_id` nor `enrichment`, the one run going on the list is stopped. If several are going, nothing is stopped, `status` is `choose` and `data.running` lists them.

**Response**

| Field          | Description                                   |
| -------------- | --------------------------------------------- |
| `status`       | `success`, `choose` or `not_found`.           |
| `data.stopped` | The runs this call stopped.                   |
| `data.running` | Runs still going on the list after this call. |
| `message`      | What happened, in one sentence.               |

Each run has the same fields as in [Running Enrichments](/get-enrichment-results/running-enrichments.md).

**Example**

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

```json
{
  "api_key": "your_api_key",
  "listname": "Pest Control Owners",
  "enrichment": "Find Company Website"
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": {
    "list_name": "Pest Control Owners",
    "stopped": [
      {
        "enrichment_id": "ea4aa3cf-f5b5-4317-8344-e1482bcd3ba2",
        "enrichment": "Find Company Website",
        "status": "running",
        "rows_done": 13,
        "rows_total": 40,
        "started_from": "MCP",
        "covers": "Whole list"
      }
    ],
    "running": []
  },
  "credits_used": 0,
  "credits_remaining": 7626.1,
  "message": "Stopped: Find Company Website. Rows already done keep their results.",
  "success": true
}
```

{% endtab %}

{% tab title="Output (several running)" %}

```json
{
  "status": "choose",
  "data": {
    "list_name": "Pest Control Owners",
    "stopped": [],
    "running": [
      { "enrichment_id": "…", "enrichment": "Find Company Website", "status": "running", "rows_done": 9, "rows_total": 40 },
      { "enrichment_id": "…", "enrichment": "Research with AI", "status": "running", "rows_done": 2, "rows_total": 10 }
    ]
  },
  "credits_used": 0,
  "message": "Several enrichments are running on this list. Pass `enrichment_id` or `enrichment` to say which one to stop. Nothing was stopped.",
  "success": true
}
```

{% endtab %}
{% endtabs %}