Skip to main content
GET
Discover supported lead filters and values
Requires leads:read. Omit filter to list the 90 supported public filter definitions. Use filter plus optional search to inspect its values. offset starts at 0; limit defaults to 50 and is capped at 100. Each definition includes its primary name, input_schema, value_mode and REST compatibility aliases. enum has a fixed allowed list; catalog provides the bundled vocabulary; free_form has no exhaustive list. Use primary names in MCP, whose schema does not advertise REST aliases.
The response supplies exact value entries and readable labels, with total and has_more. SIC/NAICS include filters use code objects; exclude filters use code strings. Company-size exclusions use numeric codes. Copy the value appropriate to the field’s input schema. All bundled job-title values are reachable through pagination, including beyond the first 70,000 entries. MCP offers this endpoint as get_lead_search_filters, with query and an opaque cursor. Neither form starts a search or spends credits.

Authorizations

X-API-Key
string
header
required

API key for authentication (prefix: sp_live_ or sp_test_)

Query Parameters

filter
string

Filter name. Omit to list supported filters.

Case-insensitive filter-name or value search.

offset
number
default:0
Required range: 0 <= x <= 1000000
limit
number
default:50
Required range: 1 <= x <= 100

Response

filters
object[]
required

Filter names, descriptions, input_schema, value_mode and compatibility aliases.

filter
string | null
required
values
object[]
required

Exact input values and readable labels. Empty for free-form filters.

total
number
required
offset
number
required
limit
number
required
has_more
boolean
required