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

# Lists Overview

> Blocklists, allowlists, watchlists — face / document / phone / email entries that automatically gate future verifications.

A **list** is a set of identity fingerprints — faces, document numbers, phones, or emails — that Contra evaluates **on every verification**. Hits raise a warning, auto-decline, or trigger review depending on the list's policy.

## Built-in lists

| List              | Source              | Policy          |
| ----------------- | ------------------- | --------------- |
| `OFAC_SDN`        | US Treasury         | `auto_decline`  |
| `EU_CONSOLIDATED` | European Commission | `auto_decline`  |
| `UN_SC`           | UN Security Council | `auto_decline`  |
| `PEP_GLOBAL`      | Global PEP database | `review`        |
| `INTERNAL_BLOCK`  | Your tenant         | `auto_decline`  |
| `INTERNAL_ALLOW`  | Your tenant         | `bypass_review` |

You can create unlimited custom lists scoped to your tenant.

## Entry types

| `entry_type` | What's stored                               |
| ------------ | ------------------------------------------- |
| `face`       | Biometric template hash (irreversible)      |
| `document`   | Document fingerprint (issuer + number hash) |
| `phone`      | Normalised E.164                            |
| `email`      | Lowercased email                            |

## Endpoints

<CardGroup cols={2}>
  <Card title="List Lists" icon="list" href="/api-reference/lists/list-lists" />

  <Card title="List Entries" icon="folder-open" href="/api-reference/lists/list-entries" />

  <Card title="Create List Entry" icon="plus" href="/api-reference/lists/create-entry" />

  <Card title="Delete List Entry" icon="trash" href="/api-reference/lists/delete-entry" />

  <Card title="Upload Face" icon="face-viewfinder" href="/api-reference/lists/upload-face" />
</CardGroup>