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

# Search Contact filters

> How title filters, departments, seniorities, and location work.

## Title filters

Two syntaxes are supported — pick one per request.

**`title_filters`** — boolean expression per named group. Supports `OR`, `AND`, `NOT`:

```json theme={null}
{
  "domain": "acme.com",
  "title_filters": [
    { "name": "sales_leaders", "filter": "head of sales OR vp sales OR director of sales" }
  ]
}
```

**`title_lists`** — explicit list of titles per named group. Useful when you have a curated set of exact titles:

```json theme={null}
{
  "domain": "acme.com",
  "title_lists": [
    { "name": "sales_leaders", "titles": ["Head of Sales", "VP of Sales", "Director of Sales"] }
  ]
}
```

Up to 5 groups per request. Multiple groups act as OR — a contact matching any group is included.

## Departments and seniorities

Optional filters that narrow results within any search mode.

**`departments`** — allowed values:

`Leadership`, `Engineering`, `Product Management`, `Sales`, `Marketing`, `Customer Success`, `Finance`, `Accounting`, `Legal`, `Human Resources`, `Information Technology`, `Operations`, `Education`, `Other`

**`seniorities`** — allowed values:

`Owner`, `CXO`, `Partner`, `Vice President`, `Director`, `Manager`, `Senior`, `Entry`, `Other`

```json theme={null}
{
  "domain": "acme.com",
  "departments": ["Sales", "Marketing"],
  "seniorities": ["Director", "Vice President"]
}
```

## Location (contact-level)

`location_countries` filters contacts by where they are located — not where the company is headquartered.

```json theme={null}
{
  "domain": "acme.com",
  "title_filters": [
    { "name": "sales_leaders", "filter": "head of sales OR vp sales" }
  ],
  "location_countries": ["United States", "Canada"]
}
```

<Tip>
  For company-set searches, use `company_location_countries` to filter by company HQ country and `location_countries` to filter by the contact's own location.
</Tip>

## Name filters

| Field            | Behavior                                                                       |
| ---------------- | ------------------------------------------------------------------------------ |
| `included_names` | Restrict results to contacts whose full name matches one of the listed strings |
| `excluded_names` | Remove contacts whose full name matches one of the listed strings              |

Useful when you want to target or skip specific individuals in a company search.