Skip to main content
POST
Search contacts

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
nextToken
string | null

An opaque cursor token for retrieving the next page of results. Returned as supplementalData.nextToken in the previous response.

​
limit
integer
default:50

The maximum number of contacts to return per page. Must be a positive integer. A larger value is reduced to 500 rather than rejected.

Required range: x <= 500
Example:

50

​
page
integer
default:1

Page number for offset-based pagination, starting at 1. nextToken is the preferred way to page through results and takes precedence when both are sent.

Example:

2

​
savedSearchId
integer

Run the filters held by a saved search instead of sending them. Get the id from GET /saved-searches. The saved search must be a contact search. Cannot be combined with any other filter; doing so returns a validation error. limit, page and nextToken are still accepted.

Example:

1234

​
companyName
string[]

Filter contacts by their company name. Accepts up to 100 company names.

Maximum array length: 100
Example:
​
companyNameSearchType
enum<string>
default:default

Controls how companyName values are matched. default matches the provided name using standard relevance matching. related broadens the search to include known subsidiaries, parent companies, and brand aliases. exact restricts results to only companies whose name is an exact match.

Available options:
default,
related,
exact
Example:

"default"

​
companyDomain
string[]

Filter contacts by their company's website domain. Accepts up to 100 domains.

Maximum array length: 100
Example:
​
contactState
string[]

Filter by the contact's or company's state or region. Accepts a US state name or abbreviation and non-US subdivisions alike ("CA", "California", "Ontario"). A US state matches under either spelling whichever one you send. Prefix a value with - to exclude it. Behavior depends on the locationType parameter. Values match a fixed vocabulary of place names spelled the way our data spells them, which is usually the English exonym — Germany's state is "Bavaria", not "Bayern". US state names and abbreviations are both resolved, so neither needs a lookup. Use GET /search/locations to find the spelling for anything else; a value the vocabulary does not hold matches no contacts and comes back under warnings, with suggestions, rather than as an error.

Maximum array length: 10
Example:
​
contactCountry
string[]

Filter by the contact's or company's country. Prefix a value with - to exclude it. Behavior depends on the locationType parameter, and values are combined with locations rather than replacing it. "US", "USA" and "United States of America" all resolve to the United States. Use GET /search/locations?types=country to find any other country's spelling; a value the vocabulary does not hold matches no contacts and comes back under warnings, with suggestions, rather than as an error.

Maximum array length: 10
Example:
​
contactZipCode
string[]

Filter by the contact's or company's zip/postal code. Prefix a value with - to exclude it. Behavior depends on the locationType parameter. Any zip/postal code is accepted; the values below are only examples.

Maximum array length: 10
Example:
​
locations
string[]

Free-form location filter — city, state/region, or country — and the only filter that reaches city-level matching. Values may be a single place ("Austin") or comma-separated to disambiguate ("Austin, Texas", "Ontario, Canada"). Prefix a value with - to exclude it. Behavior depends on the locationType parameter, and values are combined with contactCountry rather than replacing it. Cities are the largest part of the vocabulary and the part no list can enumerate — use GET /search/locations to find one, and pass the returned location string verbatim. Its count is what separates a name meaning several places: "Ontario" is a Canadian province and a larger California city.

Maximum array length: 10
Example:
​
locationRadius
enum<string> | null

Widen locations (and contactCountry) to everything within a radius of each value. The value is the radius in miles, sent as a string or a number. Only geocodable values get a radius — a city or zip code resolves to coordinates, a country does not. Use zipCodesRadius for contactZipCode. This is the form GET /saved-searches reads a radius back in, so those values can be sent straight through here. The spelled-out label (25 miles) is accepted too, as are the options 1, 2, 3, and 4 this filter originally took, which mean 25, 50, 100, and 250 miles respectively.

Available options:
25,
50,
100,
250
Example:

"50"

​
zipCodesRadius
enum<string> | null

Widen contactZipCode to everything within a radius of each zip code. The value is the radius in miles, sent as a string or a number. The spelled-out label (25 miles) is accepted too, as are the options 1, 2, 3, and 4 this filter originally took, which mean 25, 50, 100, and 250 miles respectively.

Available options:
25,
50,
100,
250
Example:

"25"

​
locationType
enum<string>
default:bothOR

Determines how location filters (locations, contactState, contactCountry, contactZipCode) are applied. contact matches the contact's personal location only. company matches the company's headquarters location only. bothOR matches if either the contact or the company location matches (default). bothAND matches only when both the contact and the company location match.

Available options:
bothOR,
bothAND,
company,
contact
Example:

"bothOR"

​
timezones
enum<string>[]

Filter by timezone. Up to 10 timezones can be specified. Behavior depends on the timezoneType parameter.

Maximum array length: 10
Available options:
Eastern (EST),
Central (CST),
Mountain (MST),
Pacific (PST),
Alaska (AKST),
Hawaii (HST),
New Zealand (NST),
Solomon (SST),
Australia Eastern (AET),
Australia Central (ACT),
Japan (JST),
China Taiwan (CTT),
Vietnam (VST),
Bangladesh (BST),
India (IST),
Indiana Eastern (IET),
Pakistan Lahore (PLT),
Near East (NET),
Middle East (MET),
Eastern African (EAT),
(Arabic) Egypt (ART),
Eastern European (EET),
European Central (ECT),
Greenwich Mean (GMT),
Central African (CAT),
Argentina (AGT),
Brazil Eastern (BET),
Canada Newfoundland (CNT),
Puerto Rico and US Virgin Islands (PRT),
Midway Islands (MIT)
Example:
​
timezoneType
enum<string>
default:bothOR

Determines how the timezones filter is applied, using the same semantics as locationType. Ignored unless timezones is provided.

Available options:
bothOR,
bothAND,
company,
contact
Example:

"bothOR"

​
department
enum<string>[]

Filter contacts by organizational department. Up to 5 departments can be specified.

Maximum array length: 5
Available options:
Sales,
Marketing,
Engineering,
Human Resources,
Finance,
IT,
Operations,
Support,
Legal,
Project Management,
Other
Example:
​
industry
enum<string>[]

Filter contacts by their company's industry classification. Up to 5 industries can be specified. Values are organized into parent categories (e.g., "Software & Information Technology") and specific sub-industries (e.g., "Computer Software").

Maximum array length: 5
Available options:
Aerospace & Defense,
Airlines & Aviation,
Aviation & Aerospace,
Defense & Space,
Military,
Agriculture,
Farming,
Horticulture,
Ranching,
Tobacco,
Apparel & Fashion,
Textiles,
Automotive,
Chemicals & Materials,
Chemicals,
Plastics,
Consumer Goods & Retail,
Consumer Goods,
Luxury Goods & Jewelry,
Retail,
Sporting Goods,
Education & Training,
E-Learning,
Education Management,
Higher Education,
Libraries,
Primary/Secondary Education,
Electronics & Hardware,
Computer Hardware,
Consumer Electronics,
Electrical & Electronic Manufacturing,
Semiconductors,
Energy & Utilities,
Oil & Energy,
Utilities,
Entertainment,
Animation,
Arts & Crafts,
Computer Games,
Fine Art,
Gambling & Casinos,
Mobile Games,
Motion Pictures & Film,
Music,
Performing Arts,
Photography,
Recreational Facilities & Services,
Sports,
Environmental,
Environmental Services,
Renewables & Environment,
Finance & Banking,
Banking,
Capital Markets,
Financial Services,
Investment Banking,
Investment Management,
Venture Capital & Private Equity,
Food & Beverage,
Dairy,
Fishery,
Food & Beverages,
Food Production,
Restaurants,
Supermarkets,
Wine & Spirits,
Government & Public Policy,
Executive Office,
Government Administration,
Government Relations,
Judiciary,
Law Enforcement,
Legislative Office,
Political Organization,
Public Policy,
Public Safety,
Health & Wellness,
Alternative Medicine,
Health, Wellness and Fitness,
Hospital & Health Care,
Medical Practice,
Mental Health Care,
Veterinary,
Hospitality & Tourism,
Events Services,
Hospitality,
Leisure, Travel & Tourism,
Museums & Institutions,
Household, Personal, & Beauty,
Consumer Services,
Cosmetics,
Furniture,
Individual & Family Services,
Insurance,
Internet & E-Commerce,
Internet,
Manufacturing & Engineering,
Civil Engineering,
Industrial Automation,
Machinery,
Mechanical or Industrial Engineering,
Railroad Manufacture,
Shipbuilding,
Marketing & Media,
Broadcast Media,
Graphic Design,
Marketing & Advertising,
Media Production,
Newspapers,
Online Media,
Printing,
Public Relations & Communications,
Publishing,
Writing & Editing,
Metals, Mining & Materials,
Building Materials,
Glass, Ceramics & Concrete,
Mining & Metals,
Paper & Forest Products,
Non-Profit,
Fund-Raising,
Non-Profit Organization Management,
Philanthropy,
Religious Institutions,
Pharmaceuticals & Medical Devices,
Biotechnology,
Medical Devices,
Nanotechnology,
Pharmaceuticals,
Professional Services & Consulting,
Accounting,
Alternative Dispute Resolution,
Civic & Social Organization,
Design,
Human Resources,
International Affairs,
International Trade & Development,
Law Practice,
Legal Services,
Management Consulting,
Market Research,
Outsourcing/Offshoring,
Professional Training & Coaching,
Program Development,
Research,
Security & Investigations,
Staffing & Recruiting,
Think Tanks,
Real Estate & Construction,
Architecture & Planning,
Commercial Real Estate,
Construction,
Facilities Services,
Real Estate,
Software & Information Technology,
Computer & Network Security,
Computer Software,
Information Services,
Information Technology & Services,
Software Development,
Telecommunications & Networking,
Computer Networking,
Telecommunications,
Wireless,
Transportation & Logistics,
Logistics & Supply Chain,
Maritime,
Package/Freight Delivery,
Packaging & Containers,
Translation & Localization,
Transportation/Trucking/Railroad,
Wholesale & Distribution,
Business Supplies & Equipment,
Import & Export,
Warehousing,
Wholesale
Example:
​
industrySicCodes
string[]

Filter contacts by their company's SIC code. Applied independently of industry, so the two can be combined or used on their own. Prefix a value with - to exclude it. Up to 5 codes can be specified.

Maximum array length: 5
Example:
​
industryNaicsCodes
string[]

Filter contacts by their company's NAICS code. Applied independently of industry, so the two can be combined or used on their own. Prefix a value with - to exclude it. Up to 5 codes can be specified. On API v2, unrecognized codes are rejected with a validation error.

Maximum array length: 5
Example:
​
fullName
string[]

Filter contacts by full name. Useful for finding specific individuals. Up to 10 names can be specified.

Maximum array length: 10
Example:
​
contactKeyword
string[]

Filter contacts by keyword matches against their profile (e.g., skills, bio, specialties). Up to 10 keywords can be specified.

Maximum array length: 10
Example:
​
keywordsIsOr
boolean
default:false

Controls how multiple contactKeyword values are combined. When false (default), a contact must match all of the keywords (AND logic). When true, matching any one of them is enough (OR logic).

Example:

false

​
jobTitle
string[]

Filter contacts by job title. Matches are based on relevance to the provided title strings. Up to 10 titles can be specified.

Maximum array length: 10
Example:
​
titlesExactMatch
boolean
default:false

Controls how jobTitle values are matched. When false (default), titles match on relevance, so "VP of Sales" also matches "Vice President, Sales". When true, only exact title matches are returned.

Example:

false

​
seniority
enum<string>[]

Filter contacts by seniority level within their organization. Up to 5 values can be specified.

Maximum array length: 5
Available options:
C-Level,
VP,
Director,
Manager,
Senior,
Entry Level,
Mid-Level,
Other
Example:
​
companyFoundedOn
enum<string>[]

Filter contacts by how recently their company was founded. Up to 4 ranges can be specified.

Maximum array length: 4
Available options:
Less than 1 Year,
Last 1-3 Years,
Last 4-10 Years,
10+ Years
Example:
​
companySize
enum<string>[]

Filter contacts by their company's employee count range. Up to 10 ranges can be specified.

Maximum array length: 10
Available options:
0 - 1 (Self-employed),
2 - 10,
11 - 50,
51 - 200,
201 - 500,
501 - 1,000,
1,001 - 5,000,
5,001 - 10,000,
10,001+
Example:
​
companyRevenue
enum<string>[]

Filter contacts by their company's estimated annual revenue range. Up to 10 ranges can be specified.

Maximum array length: 10
Available options:
$0 - $100K,
$100K - $1M,
$1M - $5M,
$5M - $20M,
$20M - $50M,
$50M - $100M,
$100M - $500M,
$500M - $1B,
$1B+
Example:
​
technologies
enum<string>[]

Filter contacts by technologies used at their company. Up to 10 technologies can be specified. Sample enum values shown for documentation only; actual values are not exhaustive and come from the API or typeahead.

Maximum array length: 10
Available options:
Salesforce,
HubSpot,
Marketo,
Outreach,
Apollo
Example:
​
technologiesIsOr
boolean
default:true

Controls how multiple technologies values are combined. When true (default), returns contacts whose company uses any of the specified technologies (OR logic). When false, returns only contacts whose company uses all of the specified technologies (AND logic).

Example:

true

​
jobChanges
object | null

Filter contacts by job change activity.

​
pastCompany
object | null

Filter contacts by past employer. When provided, names must be non-empty. names always match on relevance, so aliases and name fragments also match.

​
companyType
enum<string> | null

Filter by company type. Public = companies with a known stock ticker/exchange, Private = all others.

Available options:
Public,
Private
Example:

"Public"

​
lastModifiedAfter
string<date-time>

Return only contacts whose core data (name, title, company, phone, or email) was last updated on or after this date. Use ISO 8601 format.

Example:

"2025-09-01T11:00:00Z"

​
lastModifiedBefore
string<date-time>

Return only contacts whose core data (name, title, company, phone, or email) was last updated on or before this date. Use ISO 8601 format. Combine with lastModifiedAfter to define a date range.

Example:

"2025-09-07T11:00:00Z"

​
newsTypes
enum<string>[]

Filter contacts by recent news or events at their company. Returns contacts whose company has been associated with the specified event types. Up to 8 types can be specified.

Maximum array length: 8
Available options:
Acquisition,
Corporate Challenges,
Cost Cutting,
Expansion,
Investment,
Leadership,
Partnership,
Recognition
Example:
​
newsTypeDates
enum<string>[]

Restrict newsTypes results to a rolling window of recent days. Accepts a single value representing the number of days to look back. Only the first value is used if multiple are provided.

Maximum array length: 1
Available options:
60,
90,
180,
365
Example:
​
companyLatestFundingDates
enum<string>[]

Filter companies based on the date of their latest funding round (90, 180, 365 days or 3 years).

Maximum array length: 1
Available options:
90,
180,
365,
1095
Example:
​
companyLatestFundingClassifications
enum<string>[]

Filter companies based on the classifications of their latest funding round.

Maximum array length: 14
Available options:
Angel,
Pre-Seed,
Seed,
Series A,
Series B,
Series C,
Series D,
Series E,
Series F,
Series G,
Series H,
Series I,
Series J,
Other
Example:
​
companyLatestFundingTotals
enum<string>[]

Filter companies based on the total funding amount they have raised.

Maximum array length: 9
Available options:
$0 - $100K,
$100K - $1M,
$1M - $5M,
$5M - $20M,
$20M - $50M,
$50M - $100M,
$100M - $500M,
$500M - $1B,
$1B+
Example:
​
emailAddress
string<email>[]

Requires API v2. Filter contacts by email address. Finds contacts matching these email addresses. Accepts a single email string or an array of up to 100 emails.

Maximum array length: 100
Example:
​
phoneNumber
string[]

Requires API v2. Filter contacts by phone number. Accepts any format (e.g. "+1 (555) 123-4567"); non-digit characters are stripped automatically. Accepts a single phone number string or an array of up to 100 phone numbers.

Maximum array length: 100
Example:

Response

Contact Search Results

​
data
object[]

A list of contacts

​
supplementalData
object

Pagination metadata for the current search result set.

​
warnings
object[]

Non-fatal notices about the request, absent when there are none. The search ran regardless. Today this reports location filter values that name nowhere in the search index, which is the difference between a typo and an empty result set. A companyState and companyCountry that cannot both be true — ["Texas"] with ["Germany"] — is reported the same way, on the field companyState+companyCountry, since the pair is what company search matches on and neither half is wrong by itself. It is reported only when no combination of the two survives: the pairing is a cross product, so ["Texas", "Bavaria"] with ["United States", "Germany"] is a working search whose two dead combinations match nothing and take nothing away. Values are reported rather than rejected so that a filter which has always been accepted keeps working; a warned value matches no contacts, so treat it as a request to fix, not as a result. Use GET /search/locations to find the spelling the index holds, or read suggestions below.