> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enricho.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Lists and CSV export

> Save records you already fetched and export them as a CSV. Free: no new search and no credits.

Lists are snapshots of full records you have **already retrieved**. Saving, reading and exporting never re-run a search, so they never cost credits.

**Limits:**

* 50 lists per user and 1,000 records per list.
* Up to 100 records per `list_add` call.

## list\_create

Create a list for people or companies.

**name** `string` *required*

List name.

**entity** `string` *required*

`person` or `company`.

## list\_add

Save full records from an earlier search. Records are de-duplicated by `person_id` or `company_id`.

**list\_id** `string` *required*

The list to add to.

**records** `object[]` *required*

1–100 full public records, exactly as a search returned them.

## list\_get

Read one page of a saved list, with every stored public field.

**list\_id** `string` *required*

The list to read.

**limit** `integer`

1–100 records per page.

**offset** `integer`

0–1000.

## list\_list

List your saved lists. No parameters.

## list\_remove

Remove records from a list. The agent asks you to confirm first.

**list\_id** `string` *required*

The list to edit.

**record\_ids** `string[]` *required*

1–100 person or company IDs to remove.

## list\_delete

Delete a list and revoke its export links. The agent asks you to confirm first.

**list\_id** `string` *required*

The list to delete.

## list\_export

A private CSV download of a saved list, with every stored public field. Nested values are written as JSON, and cells that look like spreadsheet formulas are escaped.

**list\_id** `string` *required*

The list to export.

> [!WARNING]
>
> The download link works for 15 minutes and acts like a password. Only share it with the list's owner, and never post or log it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.