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

# Departments

> List accepted departments for job-search filters

List accepted departments, optionally filtered by name. Options are sorted
alphabetically and contain a display `label` and a search-ready `value`.

## Authentication and credits

Use `Authorization: Bearer YOUR_API_KEY`. An active API key is required. This
endpoint consumes no credits and works with zero or negative balances.

## Query parameters

<ParamField query="q" type="string">
  Optional name filter, up to 200 characters. Matches any part of the name,
  ignoring case and surrounding whitespace. Omit it or pass a blank value to
  return the complete list.
</ParamField>

## Example request

```bash theme={null}
curl 'https://api.sentrion.ai/api/v1/departments?q=engineering' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

## Response

```json theme={null}
{
  "departments": [
    {
      "label": "Engineering",
      "value": "Engineering"
    },
    {
      "label": "Software Engineering",
      "value": "Software Engineering"
    }
  ]
}
```

Pass each selected `value` unchanged in the `department` array of a job search.
No matches return an empty `departments` array.

## Errors

| Status | Meaning                                     |
| ------ | ------------------------------------------- |
| 403    | Missing, invalid, or inactive API key       |
| 422    | Invalid query parameters                    |
| 503    | Account information temporarily unavailable |

Errors use a `detail` field. Successful responses use the object shown above,
without a `success` or `data` wrapper.