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

Free-text query, e.g. "fintech, AI". 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
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
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

Provider results normalized to the CRM upsert shape.

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