> ## 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.

# Email → Profile

> Turn a work or personal email address into a full B2B profile: name, title, company, seniority, phones, LinkedIn, and job history.

> [!NOTE]
>
> **Endpoint** `POST /contacts/research` · **Credits** by default 1 for email, 5 for phone ([details](https://docs.seamless.ai/core-concepts/credits.md#contact-research-costs)) · **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:

| Option | Endpoint | Returns | Cost |
| - | - | - | - |
| **Full profile** (recommended) | `POST /contacts/research` with `contacts[].email` | Complete record including phones | By default 6 credits per contact for email and phone |
| **Profile preview** (v2) | `POST /v2/search/contacts` with `emailAddress` | Name, title, company, location, `searchResultId`. No phones. | Charged per results returned |

> [!NOTE]
>
> 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

```text theme={null}
Read https://docs.seamless.ai/llms.txt and https://docs.seamless.ai/api-catalog/email-to-profile.
Using my Seamless.AI API key from SEAMLESS_API_KEY, write a function that takes an email address,
calls POST https://api.seamless.ai/api/client/v1/contacts/research with {"contacts":[{"email": <email>}]},
polls GET /contacts/research/poll?requestIds=<requestId> every 3 seconds until status is done,
and returns the contact's name, title, company, phones, and LinkedIn URL.
```

## Authentication

Send your API key in the `Token` header, or `Authorization: Bearer <token>` with [OAuth](https://docs.seamless.ai/authentication/oauth.md). Create a key under [Settings → Public API](https://docs.seamless.ai/authentication/api-keys.md).

## Example

```bash Research theme={null}
curl -X POST https://api.seamless.ai/api/client/v1/contacts/research \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contacts": [{"email": "jane.doe@acme.com"}]}'
```

```bash Preview (v2) theme={null}
curl -X POST https://api.seamless.ai/api/client/v2/search/contacts \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emailAddress": ["jane.doe@acme.com", "sam@globex.com"]}'
```

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](https://docs.seamless.ai/workflows/receive-research-results-with-webhooks.md).

For Python, JavaScript, and other languages, see [Research contacts](https://docs.seamless.ai/api-reference/v1/contact-research/research-contacts.md) in the API reference.

## Reference

| Parameter | Type | Required | Description |
| - | - | - | - |
| `contacts` | object\[] | Yes | Contact enrich request. Provide an array of contacts to research by identity. Each item must include one of the following combinations: contactName and companyName (optionally include title when using isJobChange); contactName and domain; email; liProfileUrl; liSalesNavUrl; liRecruiterUrl. Intended as an alternative to searchResultIds; if both are sent, their combined length must not exceed 500. When isJobChange is true, only the contacts array should be used. Each contact is charged the same way as a searchResultId. Up to 500 values. |
| `contacts[].email` | string | Yes | Email address of the contact. Can be used as a standalone identifier without contactName or companyName. |
| `listIds` | integer\[] | No | IDs of the contact lists to add each newly saved contact to. Contacts that were already researched are not saved again, so they are not added to the lists. The lists must already belong to the authenticated user; an unknown ID fails the research request items, which report the error when you poll for them. Up to 50 values. |
| `skipDeduplicationCheck` | boolean | No | When true, research skips both duplicate checks and researches the record again, which charges credits again. By default a request is reported as `duplicate` when the same record was researched in the last few minutes, and as `contact-already-researched` when the contact is already saved in your My Contacts. Within those few minutes, a request for contact data the earlier research didn't get (for example phone after an email-only research) is researched onto that contact instead, and only the new data is charged. Repeated IDs within a single request are always collapsed into one research request. Default `false`. |

## Response

When `status` is `done`, `contact` holds the full record. Key fields:

| Field | Description |
| - | - |
| `fullName`, `jobTitle`, `seniority`, `department` | Who the person is and what they do |
| `companyName`, `companyDomain`, `companySize`, `companyIndustry` | Where they work |
| `email`, `email1`-`email3`, `email{n}EmailAI` | Emails with validation status |
| `contactPhone1`, `contactPhone1DataType`, `companyPhone1` | Direct dial or mobile, and company phone |
| `lIProfileUrl` | LinkedIn profile |
| `contactLocation`, `localTime` | Location and timezone |
| `jobHistory`, `startedAtCurrentCompany` | Tenure and prior roles |

See the [Data dictionary](https://docs.seamless.ai/api-catalog/data-dictionary.md) for every field.

## Errors

| Status | Meaning |
| - | - |
| `401` | Missing or invalid API key |
| `422` | `insufficientCredits` or `missingApiAccess` |
| `429` | Rate limit reached. Wait until `X-RateLimit-Reset`. |
| Poll `not found` | No person matched the email. |

## Related

* [Phone → Profile](https://docs.seamless.ai/api-catalog/phone-to-profile.md)
* [LinkedIn URL → Profile](https://docs.seamless.ai/api-catalog/linkedin-to-profile.md)
* [Contact Research API](https://docs.seamless.ai/api-catalog/contact-enrichment.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.