---
title: "Research contacts"
method: POST
path: "/contacts/research"
tags: ["Contact Research"]
---

# Research contacts

`POST /contacts/research`

Research contacts by searchResultId from contact search results or Contact enrich

## Request body

- object
  - `searchResultIds` string[] — Array of search result IDs obtained from a prior /search/contacts call. Each ID triggers a contact research request that consumes one credit. Mutually exclusive with the contacts property.
  - `isJobChange` boolean — When set to true, triggers a job change research for the provided contacts. Must be used together with the contacts array; cannot be used with searchResultIds.
  - `contacts` object[] — 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 Mutually exclusive with searchResultIds. When isJobChange is true, only the contacts array should be used.
    - `contactName` string — Full name of the contact to research. Required when using companyName or domain for identification.
    - `companyName` string — Name of the company the contact is associated with. Use together with contactName.
    - `title` string — Job title of the contact. Used alongside contactName and companyName when isJobChange is true to match the correct job change record.
    - `domain` string — Company website domain. Use as an alternative to companyName together with contactName.
    - `email` string — Email address of the contact. Can be used as a standalone identifier without contactName or companyName.
    - `liProfileUrl` string — LinkedIn public profile URL. Can be used as a standalone identifier.
    - `liSalesNavUrl` string — LinkedIn Sales Navigator profile URL. Can be used as a standalone identifier.
    - `liRecruiterUrl` string — LinkedIn Recruiter profile URL. Can be used as a standalone identifier.
  - `skipDeduplicationCheck` boolean — When true, research will not check for duplicate records that you already researched recently, and perform a research (which can result in credit usage)

## Response `202`

The request IDs for research

- object
  - `success` boolean — Indicates whether the research request was accepted successfully.
  - `requestIds` string[] — Array of request IDs corresponding to each contact research request. Use these IDs to poll for results via /contacts/research/poll.

## Other responses

- `401` — Unauthorized
- `422` — Insufficient credits or missing license
- `500` — Unexpected error

---

[API](https://skmtc.dev/seamless/apis/seamless-api.md) · [All operations](https://skmtc.dev/seamless/apis/seamless-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seamless/seamless-api/revisions/447164d1d713/schema)