> ## 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.

# Filter Values

Every **Find** endpoint filters on the values the Knowledge Graph publishes, and each
filter matches those values in full. Some are easy to guess, like `PUBLIC` or `RANK_1`.
Others are not: regions read `State of California`, nationalities read `American` rather
than `US`, and source languages read `English` rather than `en`.

**Filter Values** lists the values a filter accepts, so you can read them instead of
guessing. It is only supported in the API.

## Usage

```
GET /v1/knowledge-graph/{category}/values/{filter}
```

`category` is any Knowledge Graph category, and `filter` is the name of one of that
category's filters, spelled as it appears in the request body of its **Find** endpoint.

For example, the regions you can filter places by:

<CodeGroup>
  ```bash API highlight={1} theme={null}
  curl 'https://api.bigdata.com/v1/knowledge-graph/places/values/regions' \
    -H 'X-API-KEY: <your-api-key>'
  ```
</CodeGroup>

Output:

<CodeGroup>
  ```json API theme={null}
  {
    "values": [
      "A`ana",
      "Abia State",
      "Abim District",
      "Abkhazia",
      "Abruzzo Region",
      "Abseron Rayonu",
  ...
    ]
  }
  ```
</CodeGroup>

A value from that list goes straight into the filter it came from:

<CodeGroup>
  ```bash API highlight={1,5} theme={null}
  curl -X POST 'https://api.bigdata.com/v1/knowledge-graph/places' \
    -H 'Content-Type: application/json' \
    -H 'X-API-KEY: <your-api-key>' \
    --data '{
    "regions": ["State of California"]
  }'
  ```
</CodeGroup>

<Note>
  Values are returned in the form the filter accepts, so no translation is needed:
  countries come back as ISO 3166-1 alpha-2 codes, and source ranks as `RANK_1` to
  `RANK_5`, because that is what those filters take.
</Note>

The whole list is returned, sorted, with no narrowing parameter, and is capped at 5000
values.

## Availability

Every filter of every category is available, with three exceptions on sources that are
not stored in a form that can be listed: `packages`, `categories` and `tiers`. Those
return `404`, as does an unknown category or a filter that the category does not have.