Skip to main content
Endpoint POST /v2/search/contacts with phoneNumber · Credits charged per results returned · Version v2 only

Introduction

Send phone numbers in any format and get back the matching people: name, title, company, seniority, location, and LinkedIn URL. Use it to identify inbound callers, de-anonymize call-tracking numbers, and fill missing names in your CRM.
Public API v2 is in beta: v2 endpoints return 403 (noFeatureAccess) until Seamless enables v2 for your organization.
Each match carries a searchResultId. Send it to the Contact Research API to unlock emails, more phone numbers, and job history.

AI agent prompt

Authentication

Send your API key in the Token header, or Authorization: Bearer <token> with OAuth. Create a key under Settings → Public API.

Example

For Python, JavaScript, and other languages, see Search contacts (v2) in the API reference.

Reference

Most list filters also have a per-account limit on how many values one request can send, which can be lower than any maximum above. A request over it returns 400 with invalidArguments, naming the filter and its limit. You can combine phoneNumber with any Contact Search filter, for example companyDomain to confirm the employer.

Response

Each row in data is a contact preview: searchResultId, fullName, jobTitle, seniority, department, companyName, domain, city, state, country, liUrl, and company size and revenue. A number with no match returns no row and costs nothing.

Errors