Enrich person by email

curl --request POST \
  --url https://app.tryspecter.com/api/v1/people/by-email \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "email": "jane.doe@example.com"
}
'

import requests

url = "https://app.tryspecter.com/api/v1/people/by-email"

payload = { "email": "jane.doe@example.com" }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'jane.doe@example.com'})
};

fetch('https://app.tryspecter.com/api/v1/people/by-email', 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://app.tryspecter.com/api/v1/people/by-email",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'jane.doe@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tryspecter.com/api/v1/people/by-email"

	payload := strings.NewReader("{\n  \"email\": \"jane.doe@example.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.tryspecter.com/api/v1/people/by-email")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"jane.doe@example.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/people/by-email")

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

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"jane.doe@example.com\"\n}"

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

{
  "person_id": "per_34f8a8ad1f7497b83e821345",
  "last_updated": "2026-07-13 17:37:30",
  "email": "jane.doe@example.com",
  "score": 8,
  "talent_signal_ids": [
    "58323b85-153b-4d3d-8c0c-62dbf41198dc"
  ],
  "investor_signal_ids": [
    "0340bac8-bcee-46a2-94bf-cf77e0c34253"
  ],
  "profile_picture_url": "https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg",
  "first_name": "Cosmin",
  "last_name": "Urdea",
  "full_name": "Cosmin Urdea",
  "linkedin_url": "https://www.linkedin.com/in/cosmin-urdea-0848973",
  "linkedin_num_id": 11147428,
  "linkedin_urn": "ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE",
  "twitter_url": "https://x.com/moissinac",
  "github_url": "https://github.com/sarahchen9776",
  "about": "IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role.",
  "tagline": "Software Consultant / Contractor",
  "location": "Bucharest, București, Romania, Europe",
  "region": "Europe",
  "highlights": [
    "major_tech_experience",
    "prior_vc_backed_experience",
    "strong_technical_background",
    "vc_backed_experience"
  ],
  "level_of_seniority": "Senior Level",
  "years_of_experience": 21,
  "education_level": "",
  "experience": [
    {
      "company_name": "valantic (vormals mm1)",
      "linkedin_url": "https://www.linkedin.com/company/mm1",
      "title": "Senior Consultant Fintech & Digital Payment",
      "departments": [
        "Finance"
      ],
      "start_date": "2025-04-01",
      "is_current": true,
      "job_order": 13,
      "company_id": "6744b47c776432406530a72b",
      "domain": "mm1.com",
      "description": "As an Implementation Engineer at valantic, I play a pivotal role in the technical execution of Stripe integration projects, ensuring precision, efficiency, and robust infrastructure in every implementation. Leveraging deep technical expertise and payments industry experience, I design and deploy custom payment solutions that enhance operational efficiency and customer satisfaction.",
      "company_size": "51-200",
      "industry": [
        "Financial Services",
        "Financial Technology"
      ],
      "tech_verticals": [
        [
          "Blockchain, Crypto & Web3",
          "Crypto Exchanges and Trading Infrastructure"
        ]
      ],
      "end_date": "2025-03-01",
      "location": "Stuttgart, Baden-Wurttemberg, Germany, Europe",
      "founded_year": 1997
    }
  ],
  "current_position_title": "Senior Consultant Fintech & Digital Payment",
  "current_position_company_name": "valantic (vormals mm1)",
  "current_position_company_website": "mm1.com",
  "past_position_title": "Product Owner (Contracted)",
  "past_position_company_name": "Riverty",
  "past_position_company_website": "riverty.com",
  "current_tenure": 15,
  "average_tenure": 22,
  "education": [
    {
      "name": "Stanford University",
      "linkedin_url": "https://www.linkedin.com/school/stanford-university",
      "field_of_study": "Computer Science (AI track) and Statistics",
      "degree_title": "Bachelor of Science - BS",
      "description": "<p class=\"show-more-less-text__text--less\">\n        Krieger School of Arts and Sciences<br>Bloomberg School of Public Health<br>(joint degree program)\n<!---->      </p>",
      "start_date": "2024-01-01",
      "end_date": "2028-01-01",
      "location": "Stanford, California, United States, North America"
    }
  ],
  "languages": [
    {
      "name": "English",
      "proficiency_level": "Native Or Bilingual Proficiency"
    },
    {
      "name": "Mandarin Chinese",
      "proficiency_level": "Limited Working Proficiency"
    }
  ],
  "skills": [
    "API Development",
    "Agentic AI",
    "Agentic Orchestration",
    "Algorithmic Trading",
    "Algorithms",
    "Apache Spark",
    "C#",
    "C++",
    "CORS",
    "Communication"
  ],
  "linkedin_followers": 904,
  "linkedin_connections": 500
}

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Enrich

Enrich person by email

Resolves an email address to the most probable Specter person and returns that person’s full record, the same object Get person by ID returns, plus the email it resolved from and a match confidence score.

Costs 2 credits per matched result.

What you need

An email address.

Behaviour

score ranges from 1 to 10. A score of 7 or higher is generally a reliable match; treat lower scores with increasing caution.
The response carries every field of the person record, so no follow-up call is needed to read the profile.
Returns 204 if the email can’t be matched to a person.

What you do next

Open their current company. Resolve an experience[].company_id with Get company by ID.
Read their talent signals. Pass person_id to Get person talent signals.
Do it in bulk. Looking up many addresses? Use Enrich people by email (bulk).

POST

people

by-email

Enrich person by email

curl --request POST \
  --url https://app.tryspecter.com/api/v1/people/by-email \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "email": "jane.doe@example.com"
}
'

import requests

url = "https://app.tryspecter.com/api/v1/people/by-email"

payload = { "email": "jane.doe@example.com" }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'jane.doe@example.com'})
};

fetch('https://app.tryspecter.com/api/v1/people/by-email', 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://app.tryspecter.com/api/v1/people/by-email",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'jane.doe@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tryspecter.com/api/v1/people/by-email"

	payload := strings.NewReader("{\n  \"email\": \"jane.doe@example.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.tryspecter.com/api/v1/people/by-email")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"jane.doe@example.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/people/by-email")

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

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"jane.doe@example.com\"\n}"

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

{
  "person_id": "per_34f8a8ad1f7497b83e821345",
  "last_updated": "2026-07-13 17:37:30",
  "email": "jane.doe@example.com",
  "score": 8,
  "talent_signal_ids": [
    "58323b85-153b-4d3d-8c0c-62dbf41198dc"
  ],
  "investor_signal_ids": [
    "0340bac8-bcee-46a2-94bf-cf77e0c34253"
  ],
  "profile_picture_url": "https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg",
  "first_name": "Cosmin",
  "last_name": "Urdea",
  "full_name": "Cosmin Urdea",
  "linkedin_url": "https://www.linkedin.com/in/cosmin-urdea-0848973",
  "linkedin_num_id": 11147428,
  "linkedin_urn": "ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE",
  "twitter_url": "https://x.com/moissinac",
  "github_url": "https://github.com/sarahchen9776",
  "about": "IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role.",
  "tagline": "Software Consultant / Contractor",
  "location": "Bucharest, București, Romania, Europe",
  "region": "Europe",
  "highlights": [
    "major_tech_experience",
    "prior_vc_backed_experience",
    "strong_technical_background",
    "vc_backed_experience"
  ],
  "level_of_seniority": "Senior Level",
  "years_of_experience": 21,
  "education_level": "",
  "experience": [
    {
      "company_name": "valantic (vormals mm1)",
      "linkedin_url": "https://www.linkedin.com/company/mm1",
      "title": "Senior Consultant Fintech & Digital Payment",
      "departments": [
        "Finance"
      ],
      "start_date": "2025-04-01",
      "is_current": true,
      "job_order": 13,
      "company_id": "6744b47c776432406530a72b",
      "domain": "mm1.com",
      "description": "As an Implementation Engineer at valantic, I play a pivotal role in the technical execution of Stripe integration projects, ensuring precision, efficiency, and robust infrastructure in every implementation. Leveraging deep technical expertise and payments industry experience, I design and deploy custom payment solutions that enhance operational efficiency and customer satisfaction.",
      "company_size": "51-200",
      "industry": [
        "Financial Services",
        "Financial Technology"
      ],
      "tech_verticals": [
        [
          "Blockchain, Crypto & Web3",
          "Crypto Exchanges and Trading Infrastructure"
        ]
      ],
      "end_date": "2025-03-01",
      "location": "Stuttgart, Baden-Wurttemberg, Germany, Europe",
      "founded_year": 1997
    }
  ],
  "current_position_title": "Senior Consultant Fintech & Digital Payment",
  "current_position_company_name": "valantic (vormals mm1)",
  "current_position_company_website": "mm1.com",
  "past_position_title": "Product Owner (Contracted)",
  "past_position_company_name": "Riverty",
  "past_position_company_website": "riverty.com",
  "current_tenure": 15,
  "average_tenure": 22,
  "education": [
    {
      "name": "Stanford University",
      "linkedin_url": "https://www.linkedin.com/school/stanford-university",
      "field_of_study": "Computer Science (AI track) and Statistics",
      "degree_title": "Bachelor of Science - BS",
      "description": "<p class=\"show-more-less-text__text--less\">\n        Krieger School of Arts and Sciences<br>Bloomberg School of Public Health<br>(joint degree program)\n<!---->      </p>",
      "start_date": "2024-01-01",
      "end_date": "2028-01-01",
      "location": "Stanford, California, United States, North America"
    }
  ],
  "languages": [
    {
      "name": "English",
      "proficiency_level": "Native Or Bilingual Proficiency"
    },
    {
      "name": "Mandarin Chinese",
      "proficiency_level": "Limited Working Proficiency"
    }
  ],
  "skills": [
    "API Development",
    "Agentic AI",
    "Agentic Orchestration",
    "Algorithmic Trading",
    "Algorithms",
    "Apache Spark",
    "C#",
    "C++",
    "CORS",
    "Communication"
  ],
  "linkedin_followers": 904,
  "linkedin_connections": 500
}

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Authorizations

X-API-Key

string

header

required

Body

application/json

Request to resolve an email address to a person.

string

required

Email of the person to look up.

Example:

"jane.doe@example.com"

Response

The matched person's full record, plus the email it resolved from and the match confidence score.

A person matched from an email address: the full Specter person record, the same object Get person by ID returns, plus the email the match resolved from and the confidence of the match.

person_id

string

required

The Specter person ID for this person, can be used in people endpoints.

Example:

"per_34f8a8ad1f7497b83e821345"

last_updated

string

required

A date for when the person was last updated in Specter. Uses the format YYYY-MM-DD HH:MM:SS.

Example:

"2026-07-13 17:37:30"

string<email>

required

The email address this result resolved from, echoed back.

Example:

"jane.doe@example.com"

score

number

required

Confidence in the match, from 1 to 10. A score of 7 or higher is generally a reliable match; treat lower scores with increasing caution.

Example:

8

talent_signal_ids

string[] | null

Talent signal IDs for this person. To read the signals themselves, call Get person talent signals rather than resolving these IDs individually.

Example:

["58323b85-153b-4d3d-8c0c-62dbf41198dc"]

investor_signal_ids

string[] | null

Investor-interest signal IDs for this person. There is no per-person investor-interest endpoint; read these signals from the by-date feed.

profile_picture_url

string | null

A url for a profile picture if there is one.

Example:

"https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg"

first_name

string

First name

Example:

"Cosmin"

last_name

string

Last Name

Example:

"Urdea"

full_name

string

Full name

Example:

"Cosmin Urdea"

linkedin_url

string

URL for LinkedIn account.

Example:

"https://www.linkedin.com/in/cosmin-urdea-0848973"

linkedin_num_id

number

The numeric ID for the LinkedIn account.

Example:

11147428

linkedin_urn

string

The URN from LinkedIn for the account.

Example:

"ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE"

twitter_url

string | null

URL for Twitter account.

Example:

"https://x.com/moissinac"

github_url

string | null

URL for Github account.

Example:

"https://github.com/sarahchen9776"

about

string | null

A description of the person.

Example:

"IT Software Consultant / Contractor 20+ years of experience in software development - Systems and Applications Architecture - Product Design / Management - Coach and mentorship Experience in various industries, but mostly in electronic payments. After a full carrier as a full stack developer and, later on, architect, I have decided to put my experience to use from a different perspective as Product Owner/Manager and it has been already 3 years and I am enjoying very much this new role."

tagline

string | null

A shorter tagline for the person.

Example:

"Software Consultant / Contractor"

location

string | null

Where the person is located.

Example:

"Bucharest, București, Romania, Europe"

region

string | null

Main region where the person is located.

Example:

"Europe"

highlights

string[]

Type of highlight, the full list will be added shortly.

Example:

[
  "major_tech_experience",
  "prior_vc_backed_experience",
  "strong_technical_background",
  "vc_backed_experience"
]

level_of_seniority

string | null

Top level of seniority the person has achieved.

Example:

"Senior Level"

years_of_experience

number | null

Years of experience the person has worked for.

Example:

21

education_level

string | null

Top level of education that the person has.

Example:

""

experience

Experience · object[]

Companies that the person has worked for.

Show child attributes

current_position_title

string | null

Title of the person's current position

Example:

"Senior Consultant Fintech & Digital Payment"

current_position_company_name

string | null

Name of the company where the person currently works.

Example:

"valantic (vormals mm1)"

current_position_company_website

string | null

Website for the company where the person currently works.

Example:

"mm1.com"

past_position_title

string | null

Title of the person's last position

Example:

"Product Owner (Contracted)"

past_position_company_name

string | null

Name of the company where the person last left.

Example:

"Riverty"

past_position_company_website

string | null

Website for the company where the person last left.

Example:

"riverty.com"

current_tenure

number | null

Length of time the person has been in their current job.

Example:

15

average_tenure

number | null

Average length of time in a position.

Example:

22

education

Education · object[]

Educational background for the person

Show child attributes

languages

Language · object[] | null

Languages that the person speaks

Show child attributes

Example:

[
  {
    "name": "English",
    "proficiency_level": "Native Or Bilingual Proficiency"
  },
  {
    "name": "Mandarin Chinese",
    "proficiency_level": "Limited Working Proficiency"
  }
]

skills

string[]

List of skills that the person has.

Example:

[
  "API Development",
  "Agentic AI",
  "Agentic Orchestration",
  "Algorithmic Trading",
  "Algorithms",
  "Apache Spark",
  "C#",
  "C++",
  "CORS",
  "Communication"
]

linkedin_followers

number

Number of followers the person has on LinkedIn.

Example:

904

linkedin_connections

number

Number of connections the person has on LinkedIn.

Example:

500

Enrich

Search

Companies

People

Investors

Transactions

Signals

Lists

Saved Searches

Network

Account

Enrich person by email

What you need

Behaviour

What you do next

Authorizations

Body

Response