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

# Key concepts

> The few ideas the whole product is built on: workspaces, points, searches, lookups, outcomes and lists.

## Workspace

Your team's space in Loice. It owns the points balance, the searches and lists, the API keys,
the connected AI assistants and the do-not-contact entries. Every person belongs to one
workspace. See [Workspace and team](https://docs.loice.ai/workspace-and-team.md).

## Points

The currency of every paid action, in the app, the API and MCP alike. Prices are shown on every
paid button and under Settings → Billing → Action costs. See [Plans and points](https://docs.loice.ai/plans-and-points.md).

## Search vs lookup

* A **search** finds people you do not know yet, by criteria — [Leads Search](https://docs.loice.ai/leads-search.md),
  the [Employee Finder](https://docs.loice.ai/employee-finder.md). It runs **in the background**, delivers people in pages
  of 25 and is billed **per person delivered**. A workspace runs one search at a time.
* A **lookup** answers a question about one person you already know — find their email
  ([Email Finder](https://docs.loice.ai/email-finder.md)), who is behind an email ([Email enrichment](https://docs.loice.ai/email-enrichment.md)),
  their profile ([LinkedIn Finder](https://docs.loice.ai/linkedin-finder.md)). It is billed **per lookup**.

## Outcomes

Every lookup ends in one of three states, and they are billed differently:

| Outcome | Example | Billed |
| - | - | - |
| **Answered** | The email was found and verified. | Yes |
| **Answered, nothing found** | The lookup completed, and no verified email exists. | Yes — it is a real answer |
| **Not answered** | The provider timed out; our own failure. | Never |

Refusals before any work — invalid input, not enough points, rate limit, do-not-contact — are
never billed either, and a retry of the same request is never billed twice.

## Reveal

Search results show who a person is, not their contact data. **Reveal** runs the Email Finder for
one row. An email your workspace already revealed is shown again for free.

## Lists and enrichment runs

A [list](https://docs.loice.ai/lead-lists.md) collects people from any screen and from your own imports. An **enrichment
run** fills a missing column (email, LinkedIn profile, social profiles) for every row at once,
billing each row like the single lookup and never billing the same question about the same person
twice.

## Batches

Every finder screen takes a CSV (**Import CSV**). A batch runs in the background, de-duplicates
rows, stops cleanly when points run out, and gives back your file with Loice's columns added.


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