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

# Filtering

> filter[field][operator]=value with per-endpoint whitelists

<Info>
  **Quick Summary:** Filter collections with `filter[field][op]=value`. Each endpoint documents which fields are filterable; anything else is rejected with a 400 naming the field.
</Info>

## Syntax

```bash theme={null}
# careers whose name contains "engineer"
curl "https://prod.skillsdbnext.com/api/v1/careers?filter[name][like]=%25engineer%25" \
  -H "Authorization: Bearer sdb_live_YOUR_KEY_HERE"

# careers of one career type (by type name)
curl "https://prod.skillsdbnext.com/api/v1/careers?filter[careerType][eq]=Job%20Role" \
  -H "Authorization: Bearer sdb_live_YOUR_KEY_HERE"
```

`%25` is a URL-encoded `%` — the SQL-style wildcard for `like`.

## Operators

| Operator              | Meaning                            |
| --------------------- | ---------------------------------- |
| `eq` / `neq`          | equals / not equals                |
| `gt` `gte` `lt` `lte` | comparisons                        |
| `in` / `nin`          | in / not in a comma-separated list |
| `like` / `nlike`      | pattern match with `%` wildcards   |
| `isnull`              | `true` or `false`                  |

## Whitelists

Filterable fields are declared per endpoint in the reference. Unknown fields — including any attempt to filter by `companyId` — return a 400 with code `not_filterable`. Your key company boundary is enforced by the server on every query; it is never a parameter.