Skip to main content
Endpoint POST /contacts/research · Credits by default 1 for email, 5 for phone (details) · Delivery async (poll or webhook) · Versions v1, v2

Introduction

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 the Token header, or Authorization: Bearer <token> with OAuth. Create a key under Settings → Public API.

Example

The research call returns 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

When status is done, contact holds the full record. Key fields: See the Data dictionary for every field.

Errors