Get an email enrichment result

curl --request GET \
  --url https://client-api.salesfinity.co/v1/api/enrichment/email/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v1/api/enrichment/email/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v1/api/enrichment/email/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v1/api/enrichment/email/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v1/api/enrichment/email/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "_id": "6703f2d8a9e4b8d1c2f3a4c1",
  "linkedin": "https://www.linkedin.com/in/janedoe",
  "linkedin_username": "janedoe",
  "status": "completed",
  "enrichment_type": "work_email",
  "createdAt": "2026-10-03T14:10:02.117Z",
  "updatedAt": "2026-10-03T14:10:31.540Z",
  "emails": [
    {
      "_id": "6703f2f7a9e4b8d1c2f3a4d2",
      "email": "[email protected]",
      "type": "work"
    }
  ]
}

{
  "message": "Invalid ObjectId format for parameter: id",
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Email enrichment request not found.",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "socket hang up",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Enrichment API

Get an email enrichment result

Returns the current state of an email lookup. Start one with Start an email enrichment.

status is pending until the lookup resolves, then completed or not-found, which are final. processing and failed are in the schema but are not currently returned for email lookups. On completed, read the address from emails: every address of the requested type that Salesfinity holds for the profile, usually one. Before that, and on not-found, emails is normally empty.

Safe to call repeatedly, and a request is never charged twice: if a finished lookup has not been charged yet, the poll records the charge; otherwise it changes nothing. Wait a few seconds between polls and stop at a final status. The poll response has no email or external_id field; those arrive only in the callback.

GET

api

enrichment

{id}

Get an email enrichment result

curl --request GET \
  --url https://client-api.salesfinity.co/v1/api/enrichment/email/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v1/api/enrichment/email/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v1/api/enrichment/email/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v1/api/enrichment/email/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v1/api/enrichment/email/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "_id": "6703f2d8a9e4b8d1c2f3a4c1",
  "linkedin": "https://www.linkedin.com/in/janedoe",
  "linkedin_username": "janedoe",
  "status": "completed",
  "enrichment_type": "work_email",
  "createdAt": "2026-10-03T14:10:02.117Z",
  "updatedAt": "2026-10-03T14:10:31.540Z",
  "emails": [
    {
      "_id": "6703f2f7a9e4b8d1c2f3a4d2",
      "email": "[email protected]",
      "type": "work"
    }
  ]
}

{
  "message": "Invalid ObjectId format for parameter: id",
  "error": "Bad Request",
  "statusCode": 400,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Email enrichment request not found.",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "socket hang up",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Returns the current state of an email lookup started with Start an email enrichment. Polling is the fallback for the callback_url webhook. It is safe to call repeatedly, and a request is never charged twice however often you poll. Wait a few seconds between polls and stop at a final status.

Path parameters

Parameter	Type	Description
`id`	string	The `_id` returned when the request was created.

Status lifecycle

Status	Meaning
`pending`	Accepted; the lookup has not resolved yet.
`completed`	Final. An address was found; read it from `emails`. 1 credit charged.
`not-found`	Final. No address was found. No credit charged.

processing and failed appear in the schema but are not currently returned for email lookups. If you handle them, treat processing like pending.

Response (200): completed

{
  "_id": "6703f2d8a9e4b8d1c2f3a4c1",
  "linkedin": "https://www.linkedin.com/in/janedoe",
  "linkedin_username": "janedoe",
  "status": "completed",
  "enrichment_type": "work_email",
  "createdAt": "2026-10-03T14:10:02.117Z",
  "updatedAt": "2026-10-03T14:10:31.540Z",
  "emails": [
    { "_id": "6703f2f7a9e4b8d1c2f3a4d2", "email": "[email protected]", "type": "work" }
  ]
}

emails lists every address of the requested type that Salesfinity holds for the profile, usually one. Before the request completes, and on not-found, it is normally empty.

The poll response and the callback carry the address differently. The callback has a single email object; the poll has the emails array. The poll response has no email or external_id field.

Response (200): still running

{
  "_id": "6703f2d8a9e4b8d1c2f3a4c1",
  "linkedin": "https://www.linkedin.com/in/janedoe",
  "linkedin_username": "janedoe",
  "status": "pending",
  "enrichment_type": "work_email",
  "createdAt": "2026-10-03T14:10:02.117Z",
  "updatedAt": "2026-10-03T14:10:02.117Z",
  "emails": []
}

Errors

Status	When
400	`id` is not a valid ID
404	No email enrichment request has this `id`
502	Salesfinity could not reach its enrichment service. Retry after a short wait.

Authorizations

x-api-key

string

header

required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Path Parameters

string

required

The _id returned by Start an email enrichment.

Example:

"6703f2d8a9e4b8d1c2f3a4c1"

Response

Current state of the lookup.

_id

string

Enrichment request ID. Use this to poll GET /v1/api/enrichment/email/{id}.

Example:

"507f1f77bcf86cd799439011"

status

enum<string>

pending until the lookup resolves, then completed (an address was found) or not-found. processing and failed are not currently returned for email lookups; treat processing like pending.

Available options:

pending,

processing,

completed,

not-found,

failed

Example:

"pending"

linkedin_url

string

deprecated

Not returned. The profile URL is in linkedin.

Example:

"https://www.linkedin.com/in/username"

enrichment_type

enum<string>

work_email or personal_email, matching the requested type. Present from the start.

Available options:

work_email,

personal_email

object | null

deprecated

Not returned by these endpoints. The callback carries the found address as email; a poll returns it in emails.

Show child attributes

external_id

string

deprecated

Not returned by these endpoints. Your external_id comes back only in the callback.

Example:

"lead-42"

string

The LinkedIn profile URL as you sent it.

Example:

"https://www.linkedin.com/in/janedoe"

linkedin_username

string

The username from the profile URL.

Example:

"janedoe"

emails

object[]

Poll response only. Every address of the requested type that Salesfinity holds for the profile; on completed it contains the address that was found. Absent from the response to Start an email enrichment.

Show child attributes

createdAt

string<date-time>

Example:

"2026-10-03T14:10:02.117Z"

updatedAt

string<date-time>

Example:

"2026-10-03T14:10:31.540Z"

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

Get an email enrichment result

Path parameters

Status lifecycle

Response (200): completed

Response (200): still running

Errors

Authorizations

Path Parameters

Response

​Path parameters

​Status lifecycle

​Response (200): completed

​Response (200): still running

​Errors

Authorizations

Path Parameters

Response

Path parameters

Status lifecycle

Response (200): completed

Response (200): still running

Errors