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

# List Entries

> GET /v3/lists/{list_uuid}/entries/ — retrieve paginated entries in a Didit blocklist, allowlist, or custom list with search filtering. Pay-per-call.

export const AgentPromptAccordion = ({prompt, title = "AI Agent Integration Prompt"}) => {
  const [copied, setCopied] = React.useState(false);
  const handleCopy = e => {
    e.stopPropagation();
    if (!prompt) return;
    navigator.clipboard.writeText(prompt.trim()).then(() => {
      setCopied(true);
      setTimeout(() => setCopied(false), 2000);
    });
  };
  const agents = ["Claude Code", "Codex", "Cursor", "Devin", "Windsurf", "GitHub Copilot"];
  return <div className="didit-agent-card">
      {}
      <div className="didit-agent-titlebar">
        <div className="didit-agent-dots" aria-hidden="true">
          <span className="didit-agent-dot didit-agent-dot-red"></span>
          <span className="didit-agent-dot didit-agent-dot-yellow"></span>
          <span className="didit-agent-dot didit-agent-dot-green"></span>
        </div>
        <span className="didit-agent-filename">{title}</span>
        <button type="button" className={`didit-agent-copy ${copied ? "didit-agent-copy-copied" : ""}`} onClick={handleCopy} title="Copy prompt to clipboard" aria-label={copied ? "Copied!" : "Copy prompt to clipboard"}>
          {copied ? <>
              <svg width="13" height="13" viewBox="0 0 16 16" fill="none">
                <path d="M3 8.5l3.5 3.5L13 4" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
              </svg>
              <span>Copied</span>
            </> : <>
              <svg width="13" height="13" viewBox="0 0 16 16" fill="none">
                <rect x="5" y="5" width="9" height="9" rx="1.5" stroke="currentColor" strokeWidth="1.5" />
                <path d="M11 5V3.5A1.5 1.5 0 0 0 9.5 2h-6A1.5 1.5 0 0 0 2 3.5v6A1.5 1.5 0 0 0 3.5 11H5" stroke="currentColor" strokeWidth="1.5" />
              </svg>
              <span>Copy</span>
            </>}
        </button>
      </div>

      {}
      <pre className="didit-agent-body"><code>{prompt.trim()}</code></pre>

      {}
      <div className="didit-agent-footer">
        <span className="didit-agent-footer-label">Paste into</span>
        <div className="didit-agent-chips">
          {agents.map(name => <span key={name} className="didit-agent-chip">{name}</span>)}
        </div>
      </div>
    </div>;
};

<AgentPromptAccordion
  title="List Entries API Prompt"
  prompt={`Retrieve paginated entries from a Didit list through the Management API.

Endpoint:
GET https://verification.didit.me/v3/lists/{list_uuid}/entries/

Authentication:
Use the x-api-key header with my Didit API key.

Goal:
- Browse, search, or export the entries inside a specific list (blocklist, allowlist, or custom).

Path parameter:
- list_uuid — the list UUID from GET /v3/lists/.

Query parameters (all optional):
- search — substring match against value or display_label (case-insensitive).
- offset — pagination offset (default 0).
- limit — page size (default 25).

Example call:
curl -X GET "https://verification.didit.me/v3/lists/{list_uuid}/entries/?search=example" \\
-H "x-api-key: YOUR_API_KEY"

What to read from the response:
- count / next / previous — standard pagination envelope.
- results[].uuid — entry id; use as entry_uuid in DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/.
- results[].value — the blocklisted value (phone, email, document number, IP, wallet address, etc.). Stored case-insensitive and normalized.
- results[].display_label, comment, added_by — UI metadata. added_by is "api", "console", an email, or "system".
- results[].reference_session_id / reference_session_number — set when the entry was created from a verification session.
- results[].reference_object_uuid + metadata.reference_type — set when the entry was created from a transaction ("transaction"), vendor user ("vendor_user"), or vendor business ("vendor_business"). Use these to navigate back to the source entity.
- results[].metadata — may include document context (full_name, issuing_state, document_type) or face image URLs.

Failure modes:
- 401 — missing or malformed x-api-key.
- 403 — canonical { "detail": "You do not have permission to perform this action." } envelope.
- 404 — list not found in this application.

Side effects: none. This is a pure read.

For the full integration shape, see /integration/integration-prompt.`}
/>

Retrieve entries in a specific list with optional search filtering.

## Query parameters

| Parameter | Type    | Description                              |
| --------- | ------- | ---------------------------------------- |
| `search`  | string  | Search entries by value or display label |
| `offset`  | integer | Pagination offset (default: 0)           |
| `limit`   | integer | Page size (default: 25)                  |

## Response fields

| Field                      | Type            | Description                                                                                                                                                                                                            |
| -------------------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uuid`                     | string          | Unique entry ID                                                                                                                                                                                                        |
| `value`                    | string          | The blocklisted value (phone number, email, document number, IP, etc.)                                                                                                                                                 |
| `display_label`            | string          | Human-readable label                                                                                                                                                                                                   |
| `comment`                  | string          | Comment or reason for adding                                                                                                                                                                                           |
| `added_by`                 | string          | Who added the entry (`api`, `console`, email, or `system`)                                                                                                                                                             |
| `reference_session_id`     | string \| null  | Session ID this entry was created from (for session-based entries)                                                                                                                                                     |
| `reference_session_number` | integer \| null | Session number for display                                                                                                                                                                                             |
| `reference_object_uuid`    | string \| null  | UUID of the source entity — Face/KYC/Phone/Email object (for session entries), or transaction/vendor user/business UUID (for entity-based entries). Use with `metadata.reference_type` to navigate back to the source. |
| `metadata`                 | object \| null  | Structured data. May include `reference_type` (`"transaction"`, `"vendor_user"`, `"vendor_business"`), document context (`full_name`, `issuing_state`), or face image URLs.                                            |
| `created_at`               | string          | ISO 8601 timestamp                                                                                                                                                                                                     |

<RequestExample>
  ```bash theme={null}
  curl -X GET "https://verification.didit.me/v3/lists/{list_uuid}/entries/?search=example" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "count": 2,
    "next": null,
    "previous": null,
    "results": [
      {
        "uuid": "e1f2a3b4-...",
        "value": "test@example.com",
        "display_label": "",
        "comment": "Reported as fraudulent",
        "added_by": "api",
        "reference_session_id": null,
        "reference_session_number": null,
        "reference_object_uuid": null,
        "metadata": null,
        "created_at": "2025-06-09T12:26:54Z"
      },
      {
        "uuid": "a9b8c7d6-...",
        "value": "0xd15ae8c92c304c5ca11778143480e391",
        "display_label": "",
        "comment": "",
        "added_by": "console",
        "reference_session_id": null,
        "reference_session_number": null,
        "reference_object_uuid": "e7f8a9b0-1234-5678-abcd-ef0123456789",
        "metadata": {
          "reference_type": "transaction",
          "reference_id": "e7f8a9b0-1234-5678-abcd-ef0123456789"
        },
        "created_at": "2025-06-09T12:35:00Z"
      }
    ]
  }
  ```
</ResponseExample>