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

# Lists endpoints

> Risk API reference for Lists: read lists and their items with a Secret key.

Read the [Lists](https://docs.abstractapi.com/api/risk-platform/lists.md) your rules test, with a Secret key. Create lists and add or remove items in the dashboard.

| Method | Path | Key |
| - | - | - |
| `GET` | `/v1/lists` | Secret |
| `GET` | `/v1/lists/{list_id}/items` | Secret |

All paths are relative to `https://protection-api-service.vercel.app`.

## List all lists

```bash theme={null}
curl 'https://protection-api-service.vercel.app/v1/lists' \
  -H 'Authorization: Bearer sk_...'
```

Returns an array of lists:

```json theme={null}
[
  {
    "id": "verified_customers",
    "name": "Verified customers",
    "kind": "email",
    "description": "Customers verified by our support team",
    "managed_by": "manual",
    "created_at": "2026-10-01T12:00:00Z",
    "updated_at": "2026-11-04T09:30:00Z",
    "item_count": 214
  }
]
```

**id** `string`

The list ID. Rules reference this ID with `in_list` and `not_in_list`.

**kind** `string`

`email`, `ip` or `phone`.

**managed\_by** `string`

`manual` for your own lists, `system` for lists the Risk Platform maintains.

## List items

```bash theme={null}
curl 'https://protection-api-service.vercel.app/v1/lists/verified_customers/items?limit=500' \
  -H 'Authorization: Bearer sk_...'
```

**limit** `integer` (default: 500)

How many of the most recent items to return, from 1 to 5000.

**audit** `boolean` (default: false)

Also return recent changes to the list in `audit_events`.

Returns `items`, each with `id`, `list_id`, `value`, `normalized_value`, `metadata`, `source`, `first_seen_at`, `last_seen_at`, `hit_count`, `created_at` and `updated_at`.

## Errors

| Status | `reason` | Meaning |
| - | - | - |
| 400 | | Malformed request. |
| 401 | `unauthorized` | Missing or invalid key. |
| 404 | | The list doesn't exist. |


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