Phone → Profile

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

Introduction

Send up to 100 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. Each match carries a searchResultId. Send it to the Contact Research API to unlock emails, more phone numbers, and job history.

AI agent prompt

Read https://docs.seamless.ai/llms.txt and https://docs.seamless.ai/api-catalog/phone-to-profile.
Using my Seamless.AI API key from SEAMLESS_API_KEY, call
POST https://api.seamless.ai/api/client/v2/search/contacts with {"phoneNumber": [<numbers>]}.
For each match, print the phone, fullName, jobTitle, companyName, and searchResultId.

Authentication

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

Example

curl -X POST https://api.seamless.ai/api/client/v2/search/contacts \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phoneNumber": ["+1 (555) 123-4567", "5125550100"] }'

import os, requests

resp = requests.post(
    "https://api.seamless.ai/api/client/v2/search/contacts",
    headers={"Token": os.environ["SEAMLESS_API_KEY"]},
    json={"phoneNumber": ["+1 (555) 123-4567"]},
)
for person in resp.json()["data"]:
    print(person["fullName"], person["jobTitle"], person["companyName"], person["searchResultId"])

const resp = await fetch("https://api.seamless.ai/api/client/v2/search/contacts", {
  method: "POST",
  headers: { Token: process.env.SEAMLESS_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ phoneNumber: ["+1 (555) 123-4567"] }),
});
const { data } = await resp.json();

curl -X POST https://api.seamless.ai/api/client/v2/contacts/research \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "searchResultIds": ["SEARCH_RESULT_ID"] }'

Reference

Parameter	Type	Required	Description
`phoneNumber`	string or string[]	Yes	Up to 100 phone numbers in any format. Non-digit characters are stripped.
`limit`	integer	No	Results per page, up to 500. Default `50`.
`nextToken`	string	No	Cursor for the next page.

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

Status	Meaning
`400`	Invalid request, such as more than 100 numbers
`401`	Missing or invalid API key
`422`	`insufficientCredits` or `missingLicense`
`429`	Rate limit reached

Catalog

Identity resolution

Search

Contact Search filters

Company Search filters

Research

My data

Platform

Coming soon

Phone → Profile

Introduction

AI agent prompt

Authentication

Example

Reference

Response

Errors

​Introduction

​AI agent prompt

​Authentication

​Example

​Reference

​Response

​Errors

​Related

Introduction

AI agent prompt

Authentication

Example

Reference

Response

Errors

Related