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.

Scopes

publicAPI.v1.all

Public API v1

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.

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.

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. 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.

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. Values are organized into parent categories (e.g., "Software & Information Technology") and specific sub-industries (e.g., "Computer Software").

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.

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. 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.

Example:
contactKeyword
string[]

Filter contacts by keyword matches against their profile (e.g., skills, bio, specialties).

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.

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.

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.

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.

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.

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
string[]

Filter contacts by technologies used at their company. Accepts any technology name, such as Salesforce, HubSpot, or Marketo.

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. Contacts who currently work at one of the named companies are excluded, including those who held an earlier role there.

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.

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; sending more than one returns a validation error.

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 emails.

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 phone numbers.

Example:

Response

Contact Search Results

success
boolean
Example:

true

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.