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

# Lists

> Collect people from every search, import your own contacts, fill missing emails and profiles, and export or push to your CRM.

**Lists** (sidebar → **Lists**) are where the people you keep live. Every search screen saves
into them, you can import your own contacts, and an enrichment run fills the columns that are
missing.

## Create a list

Click **+ New list**, enter a **List name** (and an optional description) and click **Create**.
The new list opens straight away. You can also create one on the fly from any **Add to list**
dialog.

The index shows Name, Leads, Created and Updated, with a search box. A list still receiving people
shows how many are *in processing*.

**Archive** (the trash icon) removes a list from your lists without deleting anything; an archived
list can be **Restored**.

## Add people

Adding to a list is **free**. Use **Add to list** from:

* [Leads Search](https://docs.loice.ai/leads-search.md#add-to-a-list-or-export) and the [Employee Finder](https://docs.loice.ai/employee-finder.md);
* the [Email Finder](https://docs.loice.ai/email-finder.md), [LinkedIn Finder](https://docs.loice.ai/linkedin-finder.md) and
  [Email enrichment](https://docs.loice.ai/email-enrichment.md) — selected history rows or a whole batch (up to 1,000
  people per add);
* the [ICP Builder](https://docs.loice.ai/icp-builder.md), which creates one list per profile.

A person not found by a finder is still saved, without an email, so you can fill it later. People
already in the list are not duplicated; contacts you already had are merged. People on the
[do-not-contact list](https://docs.loice.ai/do-not-contact.md) are not added.

## Import your own contacts

**Import → CSV file**:

1. Choose a file (up to 10,000 rows and 4 MB). **Download template** gives the headers First Name,
   Last Name, Email, Company Domain, Company, Title, Industry, LinkedIn URL.
2. Check the column mapping Loice suggests. Each column maps to Full name, First name, Last name,
   Email, LinkedIn URL, Company, Company domain or website, Job title — or **Not imported**. You
   must map an email, a LinkedIn URL or a name. Phone columns are never imported.
3. Import. Imported emails are marked **Unverified**; rows with nothing that identifies a person
   are skipped. Contacts merge with ones you already have by email or LinkedIn URL.

Importing is free. **Import → From CRM** imports from a connected CRM (see
[Settings → Integrations](https://docs.loice.ai/workspace-and-team.md#account-settings)).

## Work in a list

* **Search** by name, title, company, industry or location; **Filter** adds Column / Comparison /
  Value rows; every column sorts both ways.
* Columns: First name, Last name, Profiles, Domain, Title, Company, Industry, Location, Email,
  **Email status**, **Personal email**, Created.
* **Email status**: **Verified** (found and verified by Loice), **Risky**, **Unverified**
  (imported, not checked), **Not found** (a completed search found nothing).
* **Reveal** in a row's Email cell finds that person's verified email, as in Leads Search.
* **Reveal** in a row's **Personal email** cell finds that person's personal address from their
  LinkedIn profile — delivered only when it verifies as valid. A row without a LinkedIn profile
  shows a dash and is never charged. See [Plans and points](https://docs.loice.ai/plans-and-points.md) for the price.

Select rows (or **Select all N matching people**) for: **Copy to list**, **Move to list**,
**Export selected**, **Push to CRM**, **Sync back to CRM**, and **Remove** — people leave this list,
but the contacts your workspace revealed stay with it.

## Fill columns

**+ Enrichment** runs a lookup for every row that needs it:

| Option | Fills |
| - | - |
| **Find email** | A missing email, from name and company domain ([Email Finder](https://docs.loice.ai/email-finder.md)). |
| **LinkedIn finder** | A missing LinkedIn profile, from name and company ([LinkedIn Finder](https://docs.loice.ai/linkedin-finder.md)). |
| **Email enrichment** | The LinkedIn and social profiles behind an email the row already has ([Email enrichment](https://docs.loice.ai/email-enrichment.md)). |
| **Personal email** | A verified personal address, from the row's LinkedIn profile (or the one **LinkedIn finder** finds in the same run). Rows without a profile are skipped, free. A billed miss — nothing found, or an address that did not verify — is not searched again. |

Choose the scope — **All results** (or the first N), **Current page** or **Selected** — check the
price per row and the total, and click **Run enrichment**. Progress shows above the table and the
run can be cancelled. When it finishes, the summary counts found, not found and skipped rows,
with the reason for each skip (no full name, no company domain, not a mail domain, no email to
enrich, no LinkedIn profile, do-not-contact, out of points, could not be completed). **Run history** lists past runs.

* One active run of each kind per list, at most 10,000 people per run.
* Each row is billed exactly like the single lookup: a completed search that finds nothing is
  billed; a row that is skipped or fails is not.
* People whose email you already hold — including an earlier billed miss — are not searched
  again. The same question about the same person is billed **once** across runs and lists.

## Export

**Export** → choose the scope (All results / Current page / Selected) and the format (**CSV** or
**XLSX**), then **Export**. Exports are **free**, up to 100,000 rows. People on the do-not-contact
list and phone numbers are never exported.

> [!TIP]
>
> API: `GET /api/v1/lead-lists`, `POST /api/v1/lead-lists/add`,
> `GET /api/v1/lead-lists/{listId}/members`. MCP: `list_lead_lists`, `add_to_lead_list`,
> `get_results`.


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