Skip to main content
POST
Search people

Authorizations

Authorization
string
header
required

Workspace-scoped Dench API key from workspace settings. This is the same key used by DENCH_API_KEY in sandboxes.

Body

application/json
linkedinUrl
string
fullName
string
firstName
string
lastName
string
keywords
string

Current-title text only. For profile or work descriptions, use profileKeywords. Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

companyDomain
string
companyName
string
titles
(string | object)[]

Current job titles (free text). Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 50
pastTitles
(string | object)[]

Past job titles (free text).

Maximum array length: 50
personNames
(string | object)[]
Maximum array length: 20
pastSeniorities
(string | object)[]

Seniority in any past role, independent of pastCompanyNames/pastTitles. Current seniority vocabulary plus Founding Team. Founder includes Co-Founder; C-level and Founding Team do not imply founder. Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 20
profileKeywords
(string | object)[]

Text in headline/about or any current/past work description. OR includes, global exclusions. Always loose text matching; missing evidence does not match.

Maximum array length: 50
companyKeywords
(string | object)[]

Current employer business focus/model (e.g. SaaS, B2B, Cloud), from description/tagline/business tags; distinct from legal companyTypes. Same employer as other current-job filters. Always loose text matching. May need another filter to retrieve candidates.

Maximum array length: 50
seniorities
(string | object)[]

Exact enum: Owner, Founder, C-level, Partner, VP, Head, Director, Manager, Senior.

Maximum array length: 20
jobFunctions
(string | object)[]

Exact enum, e.g. Sales, Marketing, Software. Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 20
subFunctions
(string | object)[]

Exact enum, e.g. SDR/BDR, Demand Generation. Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 50
industries
(string | object)[]

Exact enum, e.g. Software Development. Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 50
locations
(string | object)[]

Person locations — cities, states, countries, or metros (free text). Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 50
headcountRanges
(string | object)[]

Exact buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.

Maximum array length: 20
companyNames
(string | object)[]
Maximum array length: 50
pastCompanyNames
(string | object)[]
Maximum array length: 50
companyDomains
(string | object)[]
Maximum array length: 50
companyHeadquarters
(string | object)[]

Company HQ locations — cities, states, countries, or metros (free text). Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 50
companyTypes
(string | object)[]

Exact enum: Partnership, Nonprofit, Educational, Privately Held, Public Company, Self-Owned, Self-Employed, Government Agency.

Maximum array length: 10
universities
(string | object)[]

Universities attended (free text). Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 50
skills
(string | object)[]

Profile skills (free text). Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 50
languages
(string | object)[]

Spoken languages, e.g. English, German. Accepted values: see dench leads filters or https://dench.com/references/find-filter-options.json.

Maximum array length: 20
yearsInRole
object
yearsAtCompany
object
daysSinceJobChange
object
foundedYears
object

Company founded-year range, e.g. {min: 2015, max: 2024}.

exactMatch
boolean

Match free-text filters as whole strings. Default false: titles ['Founder'] also returns 'Co-Founder' and 'Founder & CEO'. Set true to narrow. Domains, LinkedIn URLs, enum filters and numeric ranges are always exact; keywords is always a loose text probe.

limit
integer
Required range: x <= 5000
offset
integer
Required range: 0 <= x <= 9007199254740991
pageToken
string

Opaque token from a previous response's metadata.nextPageToken.

preferCache
boolean

Response

Successful response

source
enum<string>
required
Available options:
live,
cache
people
object[]
required

Search results normalized to the CRM upsert shape.

resolvedPersonIds
string[]
required
creditsCharged
number
required
billing
object
metadata
object
{key}
any