All Lists

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

All Lists

POST /all_list

Listing your enrichment lists is free — no credits are charged.

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 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

Input

{
  "api_key": "your_api_key"
}

Output

{
  "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
}

Error

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

Your lists will also be available through the Parvenu dashboard.