---
title: "Get Lead Finder filter values and limits"
method: GET
path: "/lead-finder/filters"
tags: ["Lead Finder"]
---

# Get Lead Finder filter values and limits

`GET /lead-finder/filters`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/lead-finder/filters`
- Auth: HTTP bearer

Returns the values the enum filters accept (seniorities, job functions, company sizes, revenue bands, industries, countries, headquarters countries, regions and continents), the limits that apply to this workspace (page sizes, deepest page, refs per import, first-N count, running imports, and the daily browsing allowance with what is left of it today), and creditsPerProspect, what adding one person to a campaign costs. Free: no call to the data provider is made.

## Response `200`

Filter vocabulary, limits and price

- ModelsLeadFinderFilters
  - `companySizes` string[]
  - `continents` string[]
  - `countries` string[]
  - `creditsPerProspect` integer: CreditsPerProspect is what adding one person to a campaign costs, read from the pricing table at request time.
  - `headquartersCountries` string[]
  - `industries` string[]
  - `jobFunctions` string[]
  - `limits` ModelsLeadFinderLimits
    - `defaultPageSize` integer
    - `maxChipsPerField` integer
    - `maxDomainsPerField` integer
    - `maxFirstN` integer
    - `maxPage` integer
    - `maxRefsPerImport` integer
    - `maxRunningImports` integer
    - `maxSavedSearchName` integer
    - `maxSavedSearches` integer: MaxSavedSearches and MaxSavedSearchName bound the searches a workspace saves in the app, and TopUpHourUTC is the hour of the day, in UTC, a saved search's weekly top-up runs.
    - `maxValueLength` integer
    - `pageSizes` integer[]
    - `rowsLeftToday` integer: RowsLeftToday is what is left of it this UTC day.
    - `rowsPerDay` integer: RowsPerDay is the account's daily browsing allowance in result rows.
    - `topUpHourUtc` integer
  - `regions` string[]
  - `revenue` string[]
  - `seniorities` string[]

## Other responses

- `401`: Unauthorized - invalid or missing API key
- `403`: plan_required: the workspace's plan does not include Lead Finder
- `409`: provider_unavailable: the contact database is switched off
- `500`: internal

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)