# Get screener filters Every field, operator and label you can use in [Screen companies](https://financialdb.ai/documentation/api/screener.md). ## How it works {#how-it-works} - **Use field names exactly as listed.** They're qualified by statement: `accounting_metrics.net_margin`, not `net_margin`. - **Any numeric field can also be a screen's `sort_by`**, as can `end_date`. - **Domicile country, sector and industry take the labels listed here.** Matching ignores case, but `domicile_country` takes uppercase ISO codes like `GB`. ## Request {#request} `GET /api/v1/screener/filters` with your API key. AI assistants call it as the `get_screener_filters` tool, with the same parameters. ``` curl "https://financialdb.ai/api/v1/screener/filters" \ -H "Authorization: Bearer $FDB_API_KEY" ``` ## Parameters {#parameters} | Parameter | Type | Description | |---|---|---| | `include_sources` | boolean | Include available source documents and supporting evidence. Omit for data only. Default: `false`. | ## Response {#response} JSON with these fields. A field the source doesn't report is null or left out. | Field | Description | |---|---| | `metadata.domicile_country[]` | Available domicile country codes | | `metadata.sector[]` | Available sector labels | | `metadata.industry[]` | Available industry labels | | `fields[].field` | Qualified field name | | `fields[].description` | Meaning of the field | | `fields[].operators[]` | Allowed comparison operator | ## Errors {#errors} | Status | Meaning | |---|---| | 400 | Missing, unknown or invalid parameter, or an identifier that can't be looked up | | 401 | Missing, unknown or revoked API key | | 402 | No active plan or trial, or the included request allowance is used | | 403 | API access of the account is suspended | | 404 | The identifier matches nothing or is ambiguous. The match field identifies the outcome | | 429 | Over the plan's rate limit; Retry-After says when to retry | | 500 | Internal error; the same request is unlikely to succeed on retry | | 503 | The data couldn't be loaded right now; Retry-After says when to retry, when known | Errors are JSON with an `error` message saying what to fix. Errors are free. See [Errors and limits](https://financialdb.ai/documentation/api/errors-and-limits.md).