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

# List filter values

> Returns a paginated list of values in a set filter transform.

```
GET /api/v1/beam/{config_id}/transforms/{transform_uid}/filter-values
```

Returns a paginated list of values in the filter. Changes to filter values take effect immediately — no redeploy needed.

**Path parameters:**

| Parameter       | Description                     |
| :-------------- | :------------------------------ |
| `config_id`     | Pipeline configuration ID       |
| `transform_uid` | UID of the set filter transform |

**Query parameters:**

| Parameter | Default | Description                                |
| :-------- | :------ | :----------------------------------------- |
| `cursor`  | `null`  | Pagination cursor from a previous response |
| `count`   | `100`   | Number of values per page (1-10,000)       |

```bash theme={null}
curl -X GET "https://api.allium.so/api/v1/beam/${CONFIG_ID}/transforms/${TRANSFORM_UID}/filter-values?count=100" \
  -H "X-API-Key: ${ALLIUM_API_KEY}"
```

**Response:**

```json theme={null}
{
  "values": ["0x3c499c542cef5e3811e1192ce70d8cc03d5c3359", "0xc2132d05d31c914a87c6611c10748aeb04b58e8f"],
  "cursor": 42,
  "total_count": 1500
}
```

| Field         | Description                                       |
| :------------ | :------------------------------------------------ |
| `values`      | Array of values in the current page               |
| `cursor`      | Cursor for the next page, `null` if no more pages |
| `total_count` | Total number of values in the filter              |