Get Prospect Person
curl --request GET \
--url https://api.example.com/api/v1/entities/prospects/person/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/api/v1/entities/prospects/person/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/api/v1/entities/prospects/person/{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://api.example.com/api/v1/entities/prospects/person/{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 => [
"Authorization: Bearer <token>"
],
]);
$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://api.example.com/api/v1/entities/prospects/person/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/entities/prospects/person/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/entities/prospects/person/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "550e8400-e29b-41d4-a716-446655440000",
"firstName": "John",
"lastName": "Smith",
"jobTitle": "VP of Engineering",
"city": "San Francisco",
"postalCode": "94105",
"country": "United States",
"linkedinUrl": "https://www.linkedin.com/in/johnsmith",
"phones": ["+1-555-123-4567"],
"emails": ["john.smith@acme.com", "jsmith@gmail.com"],
"companyId": "660e8400-e29b-41d4-a716-446655440001",
"birthDate": null,
"departments": ["Engineering"],
"subDepartments": ["Platform"],
"functions": ["Engineering Management"],
"seniority": "VP",
"languages": [
{
"language": "English",
"level": "Native"
},
{
"language": "Spanish",
"level": "Intermediate"
}
],
"industry": "Computer Software",
"educations": [
{
"institution": {
"id": null,
"name": "Stanford University",
"logoUrl": "https://example.com/stanford.png",
"linkedinUrl": "https://www.linkedin.com/school/stanford-university"
},
"degreeName": "Master's",
"fieldOfStudy": "Computer Science",
"grade": null,
"dates": {
"start": "2008",
"end": "2010"
}
}
],
"workExperiences": [
{
"company": {
"id": null,
"name": "Acme Corporation",
"logoUrl": "https://example.com/acme.png",
"linkedinUrl": "https://www.linkedin.com/company/acme-corp",
"employees": {
"start": "1001",
"end": "5000"
}
},
"dates": {
"start": "2020-01",
"end": null
},
"profilePositions": [
{
"company": "Acme Corporation",
"description": "Leading the platform engineering team...",
"title": "VP of Engineering",
"employmentType": "Full-time",
"location": "San Francisco, CA",
"dates": {
"start": "2022-06",
"end": null
}
}
]
}
],
"skills": ["Python", "Kubernetes", "System Design", "Team Leadership"],
"certificates": [],
"linkedinProfile": {
"headline": "VP of Engineering at Acme Corporation",
"summary": "Experienced engineering leader with 15+ years...",
"pictureUrl": "https://media.licdn.com/dms/image/..."
},
"baseProviderId": "baseProvider_person_xyz789",
"bullhornId": 54321,
"crmId": null,
"leadOwnerId": null,
"consentStatus": "UNKNOWN",
"consentSource": null,
"consentUpdatedAt": null,
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-20T14:22:00.000Z",
"deletedAt": null,
"company": {
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "Acme Corporation",
"description": "Acme Corporation is a global leader in innovative solutions...",
"summary": "Enterprise software company specializing in sales automation",
"headcount": "1001-5000",
"industry": "Computer Software",
"phones": ["+1-555-987-6543"],
"linkedinUrl": "https://www.linkedin.com/company/acme-corp",
"websiteUrl": "https://acme.com",
"domain": "acme.com",
"city": "San Francisco",
"postalCode": "94105",
"country": "United States",
"logoUrl": "https://cdn.example.com/logos/acme.png",
"legalName": "Acme Corporation Inc.",
"foundedYear": 2010,
"revenue": "$50M-$100M",
"location": null,
"baseProviderId": "baseProvider_company_abc123",
"bullhornId": 12345,
"crmId": null,
"createdAt": "2024-01-10T08:00:00.000Z",
"updatedAt": "2024-01-18T12:15:00.000Z"
}
}
{
"error": {
"code": "NOT_FOUND",
"message": "Person with id 550e8400-e29b-41d4-a716-446655440000 not found"
}
}
Prospects
Get Prospect Person
Retrieves a person associated with a prospect by their unique identifier, including their associated company
GET
/
api
/
v1
/
entities
/
prospects
/
person
/
{id}
Get Prospect Person
curl --request GET \
--url https://api.example.com/api/v1/entities/prospects/person/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/api/v1/entities/prospects/person/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/api/v1/entities/prospects/person/{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://api.example.com/api/v1/entities/prospects/person/{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 => [
"Authorization: Bearer <token>"
],
]);
$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://api.example.com/api/v1/entities/prospects/person/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/entities/prospects/person/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/entities/prospects/person/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "550e8400-e29b-41d4-a716-446655440000",
"firstName": "John",
"lastName": "Smith",
"jobTitle": "VP of Engineering",
"city": "San Francisco",
"postalCode": "94105",
"country": "United States",
"linkedinUrl": "https://www.linkedin.com/in/johnsmith",
"phones": ["+1-555-123-4567"],
"emails": ["john.smith@acme.com", "jsmith@gmail.com"],
"companyId": "660e8400-e29b-41d4-a716-446655440001",
"birthDate": null,
"departments": ["Engineering"],
"subDepartments": ["Platform"],
"functions": ["Engineering Management"],
"seniority": "VP",
"languages": [
{
"language": "English",
"level": "Native"
},
{
"language": "Spanish",
"level": "Intermediate"
}
],
"industry": "Computer Software",
"educations": [
{
"institution": {
"id": null,
"name": "Stanford University",
"logoUrl": "https://example.com/stanford.png",
"linkedinUrl": "https://www.linkedin.com/school/stanford-university"
},
"degreeName": "Master's",
"fieldOfStudy": "Computer Science",
"grade": null,
"dates": {
"start": "2008",
"end": "2010"
}
}
],
"workExperiences": [
{
"company": {
"id": null,
"name": "Acme Corporation",
"logoUrl": "https://example.com/acme.png",
"linkedinUrl": "https://www.linkedin.com/company/acme-corp",
"employees": {
"start": "1001",
"end": "5000"
}
},
"dates": {
"start": "2020-01",
"end": null
},
"profilePositions": [
{
"company": "Acme Corporation",
"description": "Leading the platform engineering team...",
"title": "VP of Engineering",
"employmentType": "Full-time",
"location": "San Francisco, CA",
"dates": {
"start": "2022-06",
"end": null
}
}
]
}
],
"skills": ["Python", "Kubernetes", "System Design", "Team Leadership"],
"certificates": [],
"linkedinProfile": {
"headline": "VP of Engineering at Acme Corporation",
"summary": "Experienced engineering leader with 15+ years...",
"pictureUrl": "https://media.licdn.com/dms/image/..."
},
"baseProviderId": "baseProvider_person_xyz789",
"bullhornId": 54321,
"crmId": null,
"leadOwnerId": null,
"consentStatus": "UNKNOWN",
"consentSource": null,
"consentUpdatedAt": null,
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-20T14:22:00.000Z",
"deletedAt": null,
"company": {
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "Acme Corporation",
"description": "Acme Corporation is a global leader in innovative solutions...",
"summary": "Enterprise software company specializing in sales automation",
"headcount": "1001-5000",
"industry": "Computer Software",
"phones": ["+1-555-987-6543"],
"linkedinUrl": "https://www.linkedin.com/company/acme-corp",
"websiteUrl": "https://acme.com",
"domain": "acme.com",
"city": "San Francisco",
"postalCode": "94105",
"country": "United States",
"logoUrl": "https://cdn.example.com/logos/acme.png",
"legalName": "Acme Corporation Inc.",
"foundedYear": 2010,
"revenue": "$50M-$100M",
"location": null,
"baseProviderId": "baseProvider_company_abc123",
"bullhornId": 12345,
"crmId": null,
"createdAt": "2024-01-10T08:00:00.000Z",
"updatedAt": "2024-01-18T12:15:00.000Z"
}
}
{
"error": {
"code": "NOT_FOUND",
"message": "Person with id 550e8400-e29b-41d4-a716-446655440000 not found"
}
}
Retrieves detailed information about a specific person from the global person database. This endpoint returns the person record along with their associated company data if available.
Persons are shared across all organizations and contain enriched data aggregated from multiple lead providers.
Authentication
This endpoint does not require authentication. Person data is publicly accessible within the Lance platform.Request
string
required
The unique identifier (UUID) of the person to retrieve.
Response
Returns a person object with all available fields, including an embedded company object if the person has an associated company.Person Fields
string
required
Unique identifier (UUID) for the person.
string
required
The person’s first name.
string
required
The person’s last name.
string | null
Current job title.
string | null
Person’s city of residence or work.
string | null
Person’s postal code.
string | null
Person’s country.
string | null
LinkedIn profile URL.
array
Array of phone numbers for the person.
array
Array of email addresses for the person.
string | null
UUID of the associated company.
string | null
Date of birth in ISO 8601 format.
array
Array of department names the person belongs to.
array
Array of sub-department names.
array
Array of job functions.
string | null
Seniority level (e.g., “Director”, “Manager”, “VP”).
array
string | null
Industry the person works in.
array
array
Array of work experience records.
Show Work experience object properties
Show Work experience object properties
object | null
Company details with
id, name, logoUrl, linkedinUrl, and employees properties.object | null
Overall employment dates with
start and end properties.array | null
Array of positions held at this company, each with
company, description, title, employmentType, location, and dates properties.array
Array of skill strings.
array
object | null
string | null
UUID of the lead owner user.
string
GDPR consent status. One of:
UNKNOWN, OPTOUT.string | null
Source of consent information.
string | null
ISO 8601 timestamp of when consent was last updated.
External Identifiers
string | null
Internal provider identifier for this person.
number | null
Bullhorn CRM identifier for this person.
string | null
Generic CRM identifier for this person.
Timestamps
string | null
ISO 8601 timestamp of when the person record was created.
string | null
ISO 8601 timestamp of when the person record was last updated.
string | null
ISO 8601 timestamp of when the person was soft-deleted, if applicable.
Embedded Company
object | null
The associated company record, included when the person has a
companyId.
Contains all company fields as documented in the Get Prospect
Company endpoint.Response Examples
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"firstName": "John",
"lastName": "Smith",
"jobTitle": "VP of Engineering",
"city": "San Francisco",
"postalCode": "94105",
"country": "United States",
"linkedinUrl": "https://www.linkedin.com/in/johnsmith",
"phones": ["+1-555-123-4567"],
"emails": ["john.smith@acme.com", "jsmith@gmail.com"],
"companyId": "660e8400-e29b-41d4-a716-446655440001",
"birthDate": null,
"departments": ["Engineering"],
"subDepartments": ["Platform"],
"functions": ["Engineering Management"],
"seniority": "VP",
"languages": [
{
"language": "English",
"level": "Native"
},
{
"language": "Spanish",
"level": "Intermediate"
}
],
"industry": "Computer Software",
"educations": [
{
"institution": {
"id": null,
"name": "Stanford University",
"logoUrl": "https://example.com/stanford.png",
"linkedinUrl": "https://www.linkedin.com/school/stanford-university"
},
"degreeName": "Master's",
"fieldOfStudy": "Computer Science",
"grade": null,
"dates": {
"start": "2008",
"end": "2010"
}
}
],
"workExperiences": [
{
"company": {
"id": null,
"name": "Acme Corporation",
"logoUrl": "https://example.com/acme.png",
"linkedinUrl": "https://www.linkedin.com/company/acme-corp",
"employees": {
"start": "1001",
"end": "5000"
}
},
"dates": {
"start": "2020-01",
"end": null
},
"profilePositions": [
{
"company": "Acme Corporation",
"description": "Leading the platform engineering team...",
"title": "VP of Engineering",
"employmentType": "Full-time",
"location": "San Francisco, CA",
"dates": {
"start": "2022-06",
"end": null
}
}
]
}
],
"skills": ["Python", "Kubernetes", "System Design", "Team Leadership"],
"certificates": [],
"linkedinProfile": {
"headline": "VP of Engineering at Acme Corporation",
"summary": "Experienced engineering leader with 15+ years...",
"pictureUrl": "https://media.licdn.com/dms/image/..."
},
"baseProviderId": "baseProvider_person_xyz789",
"bullhornId": 54321,
"crmId": null,
"leadOwnerId": null,
"consentStatus": "UNKNOWN",
"consentSource": null,
"consentUpdatedAt": null,
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-20T14:22:00.000Z",
"deletedAt": null,
"company": {
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "Acme Corporation",
"description": "Acme Corporation is a global leader in innovative solutions...",
"summary": "Enterprise software company specializing in sales automation",
"headcount": "1001-5000",
"industry": "Computer Software",
"phones": ["+1-555-987-6543"],
"linkedinUrl": "https://www.linkedin.com/company/acme-corp",
"websiteUrl": "https://acme.com",
"domain": "acme.com",
"city": "San Francisco",
"postalCode": "94105",
"country": "United States",
"logoUrl": "https://cdn.example.com/logos/acme.png",
"legalName": "Acme Corporation Inc.",
"foundedYear": 2010,
"revenue": "$50M-$100M",
"location": null,
"baseProviderId": "baseProvider_company_abc123",
"bullhornId": 12345,
"crmId": null,
"createdAt": "2024-01-10T08:00:00.000Z",
"updatedAt": "2024-01-18T12:15:00.000Z"
}
}
{
"error": {
"code": "NOT_FOUND",
"message": "Person with id 550e8400-e29b-41d4-a716-446655440000 not found"
}
}
Error Codes
| Status Code | Error Code | Description |
|---|---|---|
| 404 | NOT_FOUND | No person exists with the specified ID. |
| 500 | INTERNAL_ERROR | An unexpected server error occurred. |
Notes
- The
companyfield is automatically populated when the person has a validcompanyId. If the person has no associated company or thecompanyIdis null, thecompanyfield will benull. - This endpoint is provided under the
/prospects/path for organizational purposes within the prospecting feature context. - Person data is deduplicated using LinkedIn URL, email addresses, and provider-specific IDs.