> 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/all-lists.md).

# All Lists

List all enrichment lists under your account, with metadata and download URLs for each.

## All Lists

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

{% hint style="info" %}
Listing your enrichment lists is **free** — no credits are charged.
{% endhint %}

**Headers**

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

**Body**

| Name      | Type   | Description  |
| --------- | ------ | ------------ |
| `api_key` | string | Your API Key |

**Response**

The rows are under `data`. See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

| Field                  | Description                                                                                                                                                                                                                                        |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_name`            | The list name.                                                                                                                                                                                                                                     |
| `status`               | List state: `queued`, `processing`, `done`, `not_found`, `cancelled` or `error`.                                                                                                                                                                   |
| `status_detail`        | Only present when a finished list has more to say about its result. `only contacts already in your lists` means everyone the search found was already in your account, so nothing new was added and the credits were refunded. Left out otherwise. |
| `rows`                 | Number of rows on the list.                                                                                                                                                                                                                        |
| `verified_email_count` | Rows with a verified email.                                                                                                                                                                                                                        |
| `email_found`          | Rows where an email was found.                                                                                                                                                                                                                     |
| `tags`                 | Tags on the list.                                                                                                                                                                                                                                  |
| `created_at`           | When the list was created.                                                                                                                                                                                                                         |
| `view_list`            | Link to open the list in the Parvenu app.                                                                                                                                                                                                          |
| `delete_list`          | Link that deletes the list.                                                                                                                                                                                                                        |
| `download_list`        | Link that downloads the list as CSV.                                                                                                                                                                                                               |
| `search_link`          | The feature that created the list.                                                                                                                                                                                                                 |
| `source`               | Where the list came from.                                                                                                                                                                                                                          |

`total` is the number of lists returned.

**Example**

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

```json
{
  "api_key": "your_api_key"
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": [
    {
      "list_name": "Sales Directors at Software Companies",
      "status": "done",
      "rows": 425,
      "verified_email_count": 212,
      "email_found": 318,
      "tags": [],
      "created_at": "2026-04-22 14:05:17",
      "view_list": "https://www.parvenu.io/app/list-view?user_id=mem_xxx&list_name=xxx",
      "delete_list": "https://resultfetch.api.parvenu.io/delete-list?user_id=mem_xxx&xxx",
      "download_list": "https://resultfetch.api.parvenu.io/getCurrentDataRetoolDownloadCsv?user_id=mem_xxx&list_name=xxx",
      "search_link": "Lead Enrichment",
      "source": "Lead Enrichment"
    },
    {
      "list_name": "Hubspot Employees",
      "status": "done",
      "rows": 1,
      "verified_email_count": 148,
      "email_found": 201,
      "tags": ["hubspot", "priority"],
      "created_at": "2026-04-20 09:12:44",
      "view_list": "https://www.parvenu.io/app/list-view?user_id=mem_xxx&list_name=xxx",
      "delete_list": "https://resultfetch.api.parvenu.io/delete-list?user_id=mem_xxx&list_name=xxx",
      "download_list": "https://resultfetch.api.parvenu.io/getCurrentDataRetoolDownloadCsv?user_id=mem_xxx&list_name=xx",
      "search_link": "Domain Enrichment",
      "source": "Domain Enrichment"
    }
  ],
  "total": 2,
  "credits_used": 0,
  "success": true
}
```

{% endtab %}

{% tab title="Error" %}

```json
{
  "status": "error",
  "error": { "code": "not_found", "message": "Not Found" },
  "success": false
}
```

{% endtab %}
{% endtabs %}

{% hint style="success" %}
Your lists will also be available through the Parvenu dashboard.
{% endhint %}