Search contacts
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
An opaque cursor token for retrieving the next page of results. Returned as supplementalData.nextToken in the previous response.
The maximum number of contacts to return per page. Must be a positive integer. A larger value is reduced to 500 rather than rejected.
x <= 50050
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.
2
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.
1234
Filter contacts by their company name. Accepts up to 100 company names.
100Controls 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.
default, related, exact "default"
Filter contacts by their company's website domain. Accepts up to 100 domains.
100Filter 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.
10Filter 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.
10Filter 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.
10Free-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.
10Widen 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.
25, 50, 100, 250 "50"
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.
25, 50, 100, 250 "25"
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.
bothOR, bothAND, company, contact "bothOR"
Filter by timezone. Up to 10 timezones can be specified. Behavior depends on the timezoneType parameter.
10Eastern (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) Determines how the timezones filter is applied, using the same semantics as locationType. Ignored unless timezones is provided.
bothOR, bothAND, company, contact "bothOR"
Filter contacts by organizational department. Up to 5 departments can be specified.
5Sales, Marketing, Engineering, Human Resources, Finance, IT, Operations, Support, Legal, Project Management, Other 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").
5Aerospace & 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 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.
5Filter 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.
5Filter contacts by full name. Useful for finding specific individuals. Up to 10 names can be specified.
10Filter contacts by keyword matches against their profile (e.g., skills, bio, specialties). Up to 10 keywords can be specified.
10Controls 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).
false
Filter contacts by job title. Matches are based on relevance to the provided title strings. Up to 10 titles can be specified.
10Controls 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.
false
Filter contacts by seniority level within their organization. Up to 5 values can be specified.
5C-Level, VP, Director, Manager, Senior, Entry Level, Mid-Level, Other Filter contacts by how recently their company was founded. Up to 4 ranges can be specified.
4Less than 1 Year, Last 1-3 Years, Last 4-10 Years, 10+ Years Filter contacts by their company's employee count range. Up to 10 ranges can be specified.
100 - 1 (Self-employed), 2 - 10, 11 - 50, 51 - 200, 201 - 500, 501 - 1,000, 1,001 - 5,000, 5,001 - 10,000, 10,001+ Filter contacts by their company's estimated annual revenue range. Up to 10 ranges can be specified.
10$0 - $100K, $100K - $1M, $1M - $5M, $5M - $20M, $20M - $50M, $50M - $100M, $100M - $500M, $500M - $1B, $1B+ 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.
10Salesforce, HubSpot, Marketo, Outreach, Apollo 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).
true
Filter contacts by job change activity.
Filter contacts by past employer. When provided, names must be non-empty. names always match on relevance, so aliases and name fragments also match.
Filter by company type. Public = companies with a known stock ticker/exchange, Private = all others.
Public, Private "Public"
Return only contacts whose core data (name, title, company, phone, or email) was last updated on or after this date. Use ISO 8601 format.
"2025-09-01T11:00:00Z"
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.
"2025-09-07T11:00:00Z"
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.
8Acquisition, Corporate Challenges, Cost Cutting, Expansion, Investment, Leadership, Partnership, Recognition 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.
160, 90, 180, 365 Filter companies based on the date of their latest funding round (90, 180, 365 days or 3 years).
190, 180, 365, 1095 Filter companies based on the classifications of their latest funding round.
14Angel, Pre-Seed, Seed, Series A, Series B, Series C, Series D, Series E, Series F, Series G, Series H, Series I, Series J, Other Filter companies based on the total funding amount they have raised.
9$0 - $100K, $100K - $1M, $1M - $5M, $5M - $20M, $20M - $50M, $50M - $100M, $100M - $500M, $500M - $1B, $1B+ 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.
100Requires 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.
100