Get Prospect Person

curl --request GET \
  --url https://api.example.com/api/v1/entities/prospects/person/{id} \
  --header 'Authorization: Bearer <token>'

{
  "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"
  }
}

GET

api

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>'

{
  "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"
  }
}

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.

firstName

string

required

The person’s first name.

lastName

string

required

The person’s last name.

jobTitle

string | null

Current job title.

city

string | null

Person’s city of residence or work.

postalCode

string | null

Person’s postal code.

country

string | null

Person’s country.

linkedinUrl

string | null

LinkedIn profile URL.

phones

array

Array of phone numbers for the person.

emails

array

Array of email addresses for the person.

companyId

string | null

UUID of the associated company.

birthDate

string | null

Date of birth in ISO 8601 format.

departments

array

Array of department names the person belongs to.

subDepartments

array

Array of sub-department names.

functions

array

Array of job functions.

seniority

string | null

Seniority level (e.g., “Director”, “Manager”, “VP”).

languages

array

Array of language objects.

Show Language object properties

language

string | null

Language name.

level

string | null

Proficiency level.

industry

string | null

Industry the person works in.

educations

array

Array of education records.

Show Education object properties

institution

object

Institution details with id, name, logoUrl, and linkedinUrl properties.

degreeName

string | null

Name of the degree.

fieldOfStudy

string | null

Field of study.

grade

string | null

Grade or GPA.

dates

object | null

Start and end dates with start and end properties.

workExperiences

array

Array of work experience records.

Show Work experience object properties

company

object | null

Company details with id, name, logoUrl, linkedinUrl, and employees properties.

dates

object | null

Overall employment dates with start and end properties.

profilePositions

array | null

Array of positions held at this company, each with company, description, title, employmentType, location, and dates properties.

skills

array

Array of skill strings.

certificates

array

Array of certificate records.

Show Certificate object properties

name

string | null

Certificate name.

authority

string | null

Issuing authority.

url

string | null

URL to certificate.

license_number

string | null

License or certificate number.

display_source

string | null

Display source.

date

object | null

Issue dates with start and end properties.

linkedinProfile

object | null

LinkedIn profile information.

Show LinkedIn profile properties

headline

string | null

LinkedIn headline.

summary

string | null

LinkedIn summary/about section.

pictureUrl

string | null

Profile picture URL.

leadOwnerId

string | null

UUID of the lead owner user.

GDPR consent status. One of: UNKNOWN, OPTOUT.

Source of consent information.

ISO 8601 timestamp of when consent was last updated.

External Identifiers

baseProviderId

string | null

Internal provider identifier for this person.

bullhornId

number | null

Bullhorn CRM identifier for this person.

crmId

string | null

Generic CRM identifier for this person.

Timestamps

createdAt

string | null

ISO 8601 timestamp of when the person record was created.

updatedAt

string | null

ISO 8601 timestamp of when the person record was last updated.

deletedAt

string | null

ISO 8601 timestamp of when the person was soft-deleted, if applicable.

Embedded Company

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 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 company field is automatically populated when the person has a valid companyId. If the person has no associated company or the companyId is null, the company field will be null.
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.

Search Person Prospects Autocomplete Classifications

​Authentication

​Request

​Response

​Person Fields

​External Identifiers

​Timestamps

​Embedded Company

​Response Examples

​Error Codes

​Notes

Authentication

Request

Response

Person Fields

External Identifiers

Timestamps

Embedded Company

Response Examples

Error Codes

Notes