Skip to main content
POST
/
search
/
contacts
Search contacts
curl --request POST \
  --url https://api.seamless.ai/api/client/v1/search/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nextToken": null,
  "limit": 50,
  "contactCountry": [
    "United States"
  ],
  "contactZipCode": [
    "10001"
  ],
  "locationType": "bothOR",
  "department": [
    "IT",
    "Engineering"
  ],
  "industry": [
    "Software Development"
  ],
  "jobTitle": [
    "Chief Technology Officer"
  ],
  "seniority": [
    "C-Level",
    "VP"
  ],
  "companyFoundedOn": [
    "Last 4-10 Years"
  ],
  "companySize": [
    "201 - 500"
  ],
  "companyRevenue": [
    "$5M - $20M"
  ],
  "technologies": [
    "Salesforce"
  ],
  "technologiesIsOr": true,
  "lastModifiedAfter": "2025-09-01T11:00:00Z"
}
'
{
  "data": [
    {
      "searchResultId": "708dbb34-3849-3c06-abd1-238b9a0295b3",
      "name": "Taylor Gonsalves",
      "company": "Seamless",
      "title": "Customer Success Manager, Mid Market Accounts",
      "department": "Sales",
      "seniority": "Manager",
      "domain": "seamless.ai",
      "city": "Jacksonville",
      "state": "Florida",
      "country": "United States",
      "companyCity": "Columbus",
      "companyState": "Ohio",
      "companyCountry": "United States",
      "liUrl": "https://www.linkedin.com/in/taylor-gonsalves-b9b18b196",
      "companyLIProfileUrl": "https://linkedin.com/company/seamlessai",
      "sicCode": "7389",
      "industries": [
        "Software Development",
        "Computer Software"
      ],
      "startedAtCurrentCompany": "2024-04-01",
      "titleStartedAt": "2024-04-01",
      "timeAtRole": "1 Yr 2 Mo",
      "timeAtCompany": "1 Yr 2 Mo",
      "companyFoundedOn": "2018-01-01",
      "lastModifiedAt": "2026-03-03 12:34:07",
      "companyRevenue": "$5M - $20M",
      "employeeSizeRange": "201 - 500",
      "timezone": "Eastern (EST)",
      "firstName": "Taylor",
      "middleName": "James",
      "lastName": "Gonsalves",
      "companyDomainAlias": "seamless.com",
      "contactLIRecruiterUrl": "https://www.linkedin.com/talent/search/profile/AEMAAC3xxOcBgZ5bzU1FB2g9fsiZ04QNuvnv51k",
      "contactLISalesNavUrl": "https://www.linkedin.com/sales/lead/ACoAAC3xxOcB-G4e6iCxOPRDtiJ5RKGoeWMqfFI,NAME_SEARCH",
      "contactXUrl": "https://twitter.com/taylorgonsalves",
      "companyGRURL": "https://www.google.com/search?q=Taylor%20Gonsalves%20Seamless",
      "contactCurrentCompanyYears": "2",
      "contactFBUrl": "https://www.facebook.com/public/Taylor+Gonsalves",
      "contactGURL": "https://www.google.com/search?q=Taylor+Gonsalves",
      "companyXUrl": "https://twitter.com/search?q=Seamless",
      "companyFBUrl": "https://www.facebook.com/search/top/?q=Seamless",
      "newsAndEvents": [
        {
          "title": "<string>",
          "url": "<string>",
          "date": "2023-11-07T05:31:56Z",
          "type": "<string>"
        }
      ],
      "companyFundingTotal": "135000000",
      "companyLatestFundingDate": "2018-01-01",
      "companyLatestFundingClassifications": [
        "Series D"
      ],
      "formerCompany": "<string>",
      "formerTitle": "<string>",
      "formerStartedAt": "2023-12-25",
      "formerEndedAt": "2023-12-25",
      "companyType": "Public",
      "stockTicker": "AAPL"
    }
  ],
  "supplementalData": {
    "isMore": true,
    "total": 150,
    "perPage": 5,
    "nextToken": "eyJwYWdlIjoyLCJzZWFyY2hJZCI6ImFiYzEyMyJ9"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.

Example:

50

​
companyName
string[]

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

Maximum array length: 100
Example:
["Seamless.AI"]
​
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:
["seamless.ai"]
​
contactState
enum<string>[]

Filter by the contact's or company's state or region. Behavior depends on the locationType parameter. 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:
NY,
Texas,
Florida,
VA,
CA
Example:
["California", "New York"]
​
contactCountry
enum<string>[]

Filter by the contact's or company's country. Behavior depends on the locationType parameter. 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:
United States,
Canada,
United Kingdom,
Germany,
Australia
Example:
["United States"]
​
contactZipCode
enum<string>[]

Filter by the contact's or company's zip/postal code. Behavior depends on the locationType parameter. 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:
10001,
30301,
33101,
60601,
94105
Example:
["10001"]
​
locationType
enum<string>
default:bothOR

Determines how location filters (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"

​
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:
["IT", "Engineering"]
​
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:
["Software Development"]
​
fullName
string[]

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

Maximum array length: 10
Example:
["John Smith"]
​
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:
["sales enablement"]
​
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:
["Chief Technology Officer"]
​
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:
["C-Level", "VP"]
​
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:
["Less than 1 Year", "Last 1-3 Years"]
​
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:
["201 - 500"]
​
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:
["$5M - $20M"]
​
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:
["Salesforce"]
​
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

Filter contacts by job change activity.

​
pastCompany
object

Filter contacts by past employer. When provided, names must be non-empty.

​
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:
["Acquisition", "Expansion"]
​
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:
["60"]
​
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:
["90"]
​
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:
["Series A", "Seed"]
​
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:
["$0 - $100K", "$100K - $1M"]

Response

Contact Search Results

​
data
object[]

A list of contacts

​
supplementalData
object

Pagination metadata for the current search result set.