# List Cloudflare zone lists

> The contents of a custom list (`$name`) that this zone's rules reference.

Source: https://docs.vigilbase.com/one/api/reference/services/get-services-cloudflare-zones-zone-id-lists

`GET https://one.vigilbase.com/api/services/cloudflare/zones/{zoneId}/lists`

The contents of a custom list (`$name`) that this zone's rules reference.

## Authorizations

Send one of these:

- `Authorization` (string, header, required): Bearer access token from Vigilbase Identity (`auth.vigilbase.com`), sent as `Authorization: Bearer <token>`. The CLI gets one with `vigilbase login`.
- `Authorization` (string, header, required): Organisation API key (`vb_one_…`) from **Settings → API keys** in Vigilbase One, sent as `Authorization: Bearer vb_one_…`. Read-only keys work. See [organisation API keys](https://docs.vigilbase.com/one/api#organisation-api-keys).

## Path parameters

- `zoneId` (string, required)

## Query parameters

- `customerId` (string, required)
- `name` (string, required): Pattern ^[a-z0-9_]{1,50}$.

## Responses

### 200

Success

### 401

Authentication required

### 403

Not permitted

## Example request

```bash
# Token from `vigilbase login`, or an API key (vb_one_…)
curl --request GET \
  --url 'https://one.vigilbase.com/api/services/cloudflare/zones/{zoneId}/lists?customerId={customerId}&name={name}' \
  --header "Authorization: Bearer $VIGILBASE_TOKEN"
```