Get a phone enrichment result

curl --request GET \
  --url https://client-api.salesfinity.co/v1/api/enrichment/phone/{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/phone/{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/phone/{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/phone/{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/phone/{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": "6703f3a0a9e4b8d1c2f3a4e3",
  "linkedin": "https://www.linkedin.com/in/janedoe",
  "linkedin_username": "janedoe",
  "status": "completed",
  "enrichment_type": "contact",
  "createdAt": "2026-10-03T14:15:04.221Z",
  "updatedAt": "2026-10-03T14:16:38.904Z",
  "phone_numbers": [
    {
      "_id": "6703f3f6a9e4b8d1c2f3a4f1",
      "number": "+14155550123",
      "country_code": "US",
      "type": "mobile",
      "validation": {
        "phone_number": "+14155550123",
        "is_valid": true,
        "carrier": "AT&T",
        "line_type": "mobile",
        "likely_to_answer": "P1",
        "score": 92,
        "status": "completed",
        "createdAt": "2026-10-03T14:16:30.112Z",
        "updatedAt": "2026-10-03T14:16:30.112Z"
      }
    }
  ]
}

{
  "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": "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 a phone enrichment result

Returns the current state of a phone lookup. Start one with Start a phone enrichment.

status is pending until the lookup resolves, then completed or not-found, which are final. processing is in the schema but is not currently returned, and a phone lookup never ends failed.

phone_numbers is filled only on completed and is an empty array otherwise. It lists every number Salesfinity holds for the profile, not only the one this request found, including landlines and P3 numbers kept from earlier lookups. Filter on each number’s validation before dialing.

Safe to call repeatedly, and a request is never charged twice. Wait a few seconds between polls and stop at a final status. external_id is not returned here; it arrives only in the callback.

GET

api

enrichment

phone

{id}

Get a phone enrichment result

curl --request GET \
  --url https://client-api.salesfinity.co/v1/api/enrichment/phone/{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/phone/{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/phone/{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/phone/{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/phone/{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": "6703f3a0a9e4b8d1c2f3a4e3",
  "linkedin": "https://www.linkedin.com/in/janedoe",
  "linkedin_username": "janedoe",
  "status": "completed",
  "enrichment_type": "contact",
  "createdAt": "2026-10-03T14:15:04.221Z",
  "updatedAt": "2026-10-03T14:16:38.904Z",
  "phone_numbers": [
    {
      "_id": "6703f3f6a9e4b8d1c2f3a4f1",
      "number": "+14155550123",
      "country_code": "US",
      "type": "mobile",
      "validation": {
        "phone_number": "+14155550123",
        "is_valid": true,
        "carrier": "AT&T",
        "line_type": "mobile",
        "likely_to_answer": "P1",
        "score": 92,
        "status": "completed",
        "createdAt": "2026-10-03T14:16:30.112Z",
        "updatedAt": "2026-10-03T14:16:30.112Z"
      }
    }
  ]
}

{
  "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": "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 a phone lookup started with Start a phone 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. A dialable number was found; see `phone_numbers`. 1 credit charged.
`not-found`	Final. No source returned a number that is valid, not a landline and not `P3`. No credit charged.

processing appears in the schema but is not currently returned, and a phone lookup never ends failed.

phone_numbers is returned only on a completed request. Until then it is an empty array, even if Salesfinity already holds numbers for the profile from an earlier lookup.

Response (200): completed

{
  "_id": "6703f3a0a9e4b8d1c2f3a4e3",
  "linkedin": "https://www.linkedin.com/in/janedoe",
  "linkedin_username": "janedoe",
  "status": "completed",
  "enrichment_type": "contact",
  "phone_numbers": [
    {
      "_id": "6703f3f6a9e4b8d1c2f3a4f1",
      "number": "+14155550123",
      "country_code": "US",
      "type": "mobile",
      "validation": {
        "phone_number": "+14155550123",
        "is_valid": true,
        "carrier": "AT&T",
        "line_type": "mobile",
        "likely_to_answer": "P1",
        "score": 92,
        "status": "completed",
        "createdAt": "2026-10-03T14:16:30.112Z",
        "updatedAt": "2026-10-03T14:16:30.112Z"
      }
    }
  ],
  "createdAt": "2026-10-03T14:15:04.221Z",
  "updatedAt": "2026-10-03T14:16:38.904Z"
}

phone_numbers is everything Salesfinity holds for that LinkedIn profile, not only what this request found. A profile enriched twice returns the accumulated list both times.

Phone number object

Field	Type	Description
`_id`	string	ID of the stored number.
`number`	string	The number in E.164 format.
`country_code`	string \| null	ISO 3166-1 alpha-2 country of the number (`US`, `GB`), not a dialing prefix. `null` when the number could not be parsed.
`type`	string	`mobile`, `direct` (a fixed line) or `office`, inferred from the number.
`extension`	string	Dial extension. Absent when there is none.
`validation`	object	Result of phone validation; see below.

Salesfinity does not return which source supplied a number.

Validation object

Field	Type	Description
`phone_number`	string	The number that was validated.
`is_valid`	boolean	Whether the number passed validation. Numbers that fail are never stored.
`carrier`	string	Carrier reported by the validator.
`line_type`	string	Line classification, such as `mobile` or `landline`.
`likely_to_answer`	string	Answer-likelihood tier, `P1` (most likely) to `P3`. Absent when the number could not be graded.
`score`	number \| null	Activity score the tier is derived from. `null` or absent when unavailable.
`status`	string	`completed` once validation finished; `pending` while it is still running.
`updatedAt`	string	When the number was last validated. A result is reused for up to six months.

A request only completes on a number that is valid, is not a landline and is not tier P3; anything else sends the lookup on to the next source. Landlines and P3 numbers found along the way are kept on the profile and appear in the array, so filter on validation rather than assuming every entry is dial-worthy.

Response (200): still running

{
  "_id": "6703f3a0a9e4b8d1c2f3a4e3",
  "linkedin": "https://www.linkedin.com/in/janedoe",
  "linkedin_username": "janedoe",
  "status": "pending",
  "enrichment_type": "contact",
  "phone_numbers": [],
  "createdAt": "2026-10-03T14:15:04.221Z",
  "updatedAt": "2026-10-03T14:15:04.221Z"
}

Errors

Status	When
400	`id` is not a valid ID
404	No phone 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 a phone enrichment.

Example:

"6703f3a0a9e4b8d1c2f3a4e3"

Response

Current state of the lookup.

_id

string

Enrichment request ID. Use this to poll GET /v1/api/enrichment/phone/{id}, and to match the request_id in the callback.

Example:

"507f1f77bcf86cd799439011"

status

enum<string>

pending until the lookup resolves, then completed (a dialable number was found) or not-found. processing is not currently returned, and a phone lookup never resolves to failed.

Available options:

pending,

processing,

completed,

not-found

string

The LinkedIn profile URL as you sent it.

Example:

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

linkedin_username

string

The username extracted from the LinkedIn URL.

Example:

"username"

enrichment_type

enum<string>

Always contact for phone enrichment.

Available options:

contact

phone_numbers

object[]

Every number Salesfinity holds for the profile, not only the one this request found, including landlines and P3 numbers kept from earlier lookups. Populated only when status is completed; an empty array otherwise. Absent from the response to Start a phone enrichment.

Show child attributes

createdAt

string<date-time>

Example:

"2026-08-27T10:15:04.221Z"

updatedAt

string<date-time>

Example:

"2026-08-27T10:16:38.904Z"

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

Get a phone enrichment result

Path parameters

Status lifecycle

Response (200): completed

Phone number object

Validation object

Response (200): still running

Errors

Authorizations

Path Parameters

Response

​Path parameters

​Status lifecycle

​Response (200): completed

​Phone number object

​Validation object

​Response (200): still running

​Errors

Authorizations

Path Parameters

Response

Path parameters

Status lifecycle

Response (200): completed

Phone number object

Validation object

Response (200): still running

Errors