---
title: "Find contacts from identifiers"
method: POST
path: "/enrichments/by-identifier"
---

# Find contacts from identifiers

`POST /enrichments/by-identifier`

## Request

- Base URL: `https://api.instalent.io/api/v1`
- URL: `https://api.instalent.io/api/v1/enrichments/by-identifier`
- Auth: HTTP bearer and API key in header `X-Customer-Key`

Contacts for people who did not come from our search. Send each person with one or more identifiers: a LinkedIn profile URL, an email address, or a name together with a company. A phone number is not an identifier and is refused. This creates an ordinary enrichment job, so poll GET /enrichments/{id}, stream its events, or wait for the enrichment.completed webhook exactly as you would for the other route; GET /enrichments/{id}/results keys each answer by your own ref instead of a profile id.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `people` object[], required
    - `ref` string
    - `identifiers` union[], required
      - union
        - object
          - `type` 'linkedin', required
          - `value` string, required
        - object
          - `type` 'email', required
          - `value` string, email, required
        - object
          - `type` 'name', required
          - `value` string, required
          - `company` string, required
  - `fields` string[], required

## Response `200`

Replayed: this Idempotency-Key already created a job, so the original is returned.

- object
  - `id` string, required
  - `kind` 'search' | 'enrichment' | 'analysis', required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled', required
  - `input` object, required
  - `progress` object, nullable, required
    - `phase` string
    - `current` number
    - `total` number
  - `summary` object, nullable, required
  - `error` object, nullable, required
    - `code` string, required
    - `message` string, required
    - `retryable` boolean
  - `createdAt` string, required
  - `startedAt` string, nullable, required
  - `finishedAt` string, nullable, required
  - `links` object
    - `self` string
    - `results` string
    - `events` string
    - `cancel` string

## Other responses

- `202`: OK
- `4XX`: Error

---

[API](https://skmtc.dev/instalent/apis/instalent-integrator-api.md) · [All operations](https://skmtc.dev/instalent/apis/instalent-integrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instalent/apis/instalent-integrator-api/revisions/eda181144149?raw)