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

# list_entity_filter_values

> List valid filter values for organizations, people, places, and products.

## Overview

The `list_entity_filter_values` tool returns the values accepted by a
[`find_entities`](/mcp-reference/tools/find-entities) filter. Use it before filtering
when you do not know the exact spelling or format of a value.

## When to Use

Use `list_entity_filter_values` when:

* A `find_entities` filter requires an exact value and its spelling or format is
  unknown
* A broad description needs to be mapped to an available classification
* A filter returns no matches and its value needs to be checked

For example, a request for government-run investment funds can be mapped to the
`Sovereign Wealth Fund` organization type.

## Parameters

| Parameter     | Type   | Required | Description                                                       |
| :------------ | :----- | :------- | :---------------------------------------------------------------- |
| `entity_type` | enum   | Yes      | Entity category: `organization`, `person`, `place`, or `product`. |
| `filter`      | string | Yes      | Filter to list. The available filters depend on `entity_type`.    |

## Filters

| `entity_type`  | Available filters                                           |
| :------------- | :---------------------------------------------------------- |
| `organization` | `types`, `countries`, `owners`                              |
| `person`       | `positions`, `employers`, `nationalities`, `genders`        |
| `place`        | `categories`, `types`, `continents`, `countries`, `regions` |
| `product`      | `types`, `owners`                                           |

## How It Works

The tool returns a `values` array for the selected entity type and filter. The agent
can select the value that best matches the user's request and pass it unchanged to the
corresponding `find_entities` filter.

Country values are returned as ISO 3166-1 alpha-2 codes, such as `US`, `FR`, and `GB`.

<Note>
  Some filters have very large value sets. The returned list may be incomplete, so a
  value that is not listed may still be accepted by `find_entities`.
</Note>