Endpoint
POST /contacts/research · Credits by default 1 for email, 5 for phone (details) · Delivery async (poll or webhook) · Versions v1, v2Introduction
Send an email address and get back the person behind it: full name, current title and company, seniority, department, location, LinkedIn profile, direct dials, mobile numbers, other emails, and job history. Use it to enrich inbound leads, clean CRM records, and route form fills. There are two ways to resolve an email:The profile-preview option uses Public API v2, which is in beta: v2 endpoints return
403 (noFeatureAccess) until Seamless enables v2 for your organization.AI agent prompt
Authentication
Send your API key in theToken header, or Authorization: Bearer <token> with OAuth. Create a key under Settings → Public API.
Example
202 with one entry in requestIds per contact. Poll each ID until status is no longer queued or researching, or receive results by webhook.
For Python, JavaScript, and other languages, see Research contacts in the API reference.
Reference
Response
Whenstatus is done, contact holds the full record. Key fields:
See the Data dictionary for every field.