# Filters

**Filter APIs:** Retrieve available filter values for prospecting.

Use the discovery endpoints to list all available filter types, then fetch valid values for a specific filter type before building a prospecting request.

**Contact filter types:** `departments`, `seniority`, `existingDataPoints`, `countries`, `locations`

**Company filter types:** `names`, `sizes`, `revenues`, `locations`, `sics`, `naics`, `industriesLabels`, `intentTopics`, `technologies`


## Get Contact Filter Types (Discovery)

 - [GET /v3/contacts/prospecting/filters](https://docs.lusha.com/apis/openapi/filters/getcontactfiltertypes.md): Returns all available filter types for contact prospecting and whether each requires a search query.

## Get Contact Filter Values

 - [GET /v3/contacts/prospecting/filters/{filterType}](https://docs.lusha.com/apis/openapi/filters/getcontactfiltervalues.md): Returns valid values for a single contact filter type.

| Filter type | Query required? |
|---|---|
| departments | No |
| seniority | No |
| existingDataPoints | No |
| countries | No |
| locations | Yes (2-256 chars) |

## Get Company Filter Types (Discovery)

 - [GET /v3/companies/prospecting/filters](https://docs.lusha.com/apis/openapi/filters/getcompanyfiltertypes.md): Returns all available filter types for company prospecting and whether each requires a search query.

## Get Company Filter Values

 - [GET /v3/companies/prospecting/filters/{filterType}](https://docs.lusha.com/apis/openapi/filters/getcompanyfiltervalues.md): Returns valid values for a single company filter type.

| Filter type | Query required? |
|---|---|
| sizes | No |
| revenues | No |
| sics | No |
| naics | No |
| intentTopics | No |
| industriesLabels | No |
| names | Yes (2-256 chars) |
| technologies | Yes (2-256 chars) |
| locations | Yes (2-256 chars) |