Skip to main content
GET
Get Contact Filter Types (Discovery)
This is the discovery step of the contact filters flow. It returns every filter type you can use when building a Prospecting Contacts request, along with a requiresQuery flag telling you whether that filter type needs a search term or returns its full value list directly.
Two-step filter pattern

Endpoint

Authentication

string
required
Your Lusha API key.
This endpoint takes no query parameters or request body - it always returns the same set of filter types.

Response

object[]
One entry per contact filter type.
object[]
A catalog of every field you can send in a Prospecting Contacts request body, one entry per field path. Use it to build or validate search requests without hard-coding the filter list.
string
When this list was generated (ISO 8601).

Error codes

Example

Example response
The filters array above is shortened to two entries. The full response lists every field path (about 270).
This list is stable - cache it rather than calling it before every search. Move straight to Contact Filter Values once you know which filter type you need.

Authorizations

api_key
string
header
required

Your Lusha API key. You can find this in your Lusha dashboard under API settings. Include this key in the api_key header for all requests.

Response

Successful response

availableFilters
object[]
filters
object[]

Catalog of every field you can send in the search request body, one entry per path

generatedAt
string<date-time>

When this list was generated