Person Object Model

Key: person

The person Object Model within the profileAPI system is for people profiles that work or belong to company. The following are the fields that are included in person.

About

Id

Key: id
Data Type: uuid
Premium: false
Description: A universally unique identifier (UUID) compliant with RFC 4122 specification, used to uniquely identify entities in the system. Presented without hyphens.
Example: 9e6a55b258ef11edb8780242ac120002

Name

Key: name
Data Type: string
Premium: false
Description: The full name of the person, including first and last names. It may also include middle names or initials.
Example: Jon Doe

First Name

Key: firstName
Data Type: string
Premium: false
Description: The given name of the person.
Example: Jon

Last Name

Key: lastName
Data Type: string
Premium: false
Description: The person's family name or surname.
Example: Doe

Photo Url

Key: photoUrl
Data Type: url
Premium: false
Description: URL to the person's photo.
Example: https://d1hbpr09pwz0sk.cloudfront.net/logourl/06f524f

Birth Year

Key: birthYear
Data Type: number
Premium: false
Description: The year in which the person was born, represented as a four-digit number (YYYY).
Example: 1986

Contacts

Emails

Key: emails
Data Type: Array of <object>
Premium: true
Description: An array of email objects representing a person's email addresses. Each object includes detailed properties such as the email address, its type, the last validation date, and a reliability score.
Example:

[
  {
    "email": "[email protected]",
    "type": "professional",
    "lastValidatedAt": "2020-08-12T02:12:33.231Z",
    "scoreValue": 0.95
  }
]

Email

Key: emails:email
Data Type: email
Description: Represents an email address, conforming to the standard format defined in RFC 5322.
Example: [email protected]

Type

Key: emails:type
Data Type: string
Description: Indicates the type of email, which must be either professional or personal.
Example: emails:professional

Last Validated At

Key: emails:lastValidatedAt
Data Type: date
Description: An ISO 8601 formatted date string that indicates when the email was last validated.
Example: 2020-08-12T02:12:33.231Z

Score Value

Key: emails:scoreValue
Data Type: number
Description: A numerical value between 0 and 1 that reflects the quality or reliability of the email.
Example: 0.95

Phones

Key: phones
Data Type: Array of <object>
Premium: true
Description: An array of phone objects representing a person's phone numbers. Each object includes detailed properties such as the phone number, its type, the last validation date, and a reliability score.
Example:

[
  {
    "phone": "+1234567890",
    "type": "mobile",
    "lastValidatedAt": "2020-08-12T02:12:33.231Z",
    "scoreValue": 0.90
  }
]

Phone

Key: phones:phone
Data Type: phone
Description: Represents a phone number formatted according to the E.164 international numbering standard.
Example: +1234567890

Type

Key: phones:type
Data Type: string
Description: Indicates the type of phone number, which must be either business or mobile.
Example: mobile

Last Validated At

Key: phones:lastValidatedAt
Data Type: date
Description: An ISO 8601 formatted date string that indicates when the phone number was last validated.
Example: 2020-08-12T02:12:33.231Z

Score Value

Key: phones:scoreValue
Data Type: number
Description: A numerical value between 0 and 1 that reflects the quality or reliability of the phone number.
Example: 0.90

Location

United States State Code

Key: unitedStatesStateCode
Data Type: string
Premium: false
Description: The two-letter code representing the U.S. state where the person is located.
Example: CA

Complete List

United States City

Key: unitedStatesCity
Data Type: string
Premium: false
Description: The city within the United States where the person is located.
Example: Seattle

United States Zip Code

Key: unitedStatesZipCode
Data Type: string
Premium: false
Description: The postal code corresponding to the person's location in the United States.
Example: 98119

United States Region

Key: unitedStatesRegion
Data Type: string
Premium: false
Description: The region within the United States where the person is located.
Example: West Coast

Complete List

Country Code

Key: countryCode
Data Type: string
Premium: false
Description: The ISO 3166-1 alpha-2 country code representing the country where the person is located.
Example: US

Complete List

World Region

Key: worldRegion
Data Type: string
Premium: false
Description: The global region where the person is located.
Example: MENA

Complete List

Experiences

Key: experiences
Data Type: Array of <object>
Description: An array representing the work experiences of a person.
Example:

[
    {
      "id": "9e6a55b258ef11edb8780242ac120002",
      "name": "Acme, Inc.",
      "department": "Human Resources",
      "team": "Recruitment and Staffing",
      "role": "Individual Contributor",
      "seniority": "Director",
      "startedAt": "2020-03-01",
      "endedAt": "2023-04-22"
    }
]

Experience: id

Key: experiences.id
Data Type: uuid
Premium: false
Description: The unique identifier for the company where the person worked.
Example: "9e6a55b258ef11edb8780242ac120002"

Experience: name

Key: experiences.name
Data Type: string
Premium: false
Description: The name of the company where the person worked.
Example: Acme, Inc.

info

Only the latest experience is returned when non-premium data is requested. When premium is set to true, all experiences will be returned.

Experience: department

Key: experiences.department
Data Type: string
Premium: false
Description: Our AI has classified a person into a department based on their public information. This value is automatically determined to ensure accuracy without the need for manual data cleanup.
Example: Human Resources

Complete List

Experience: team

Key: experiences.team
Data Type: string
Premium: true
Description: The team within the department that the person belonged to. Our AI classifies individuals into specific teams based on public information, ensuring data accuracy without manual cleanup.
Example: Recruitment and Staffing

Complete List

Experience: role

Key: experiences.role
Data Type: string
Premium: true
Description: Our AI classifies a person's role based on public information and signals, indicating their function within the organization.
Example: Individual Contributor

Role	Description
Individual Contributor	Focuses on tasks and execution without managing a team.
Manager	Oversees a team, providing leadership and direction.

Experience: seniority

Key: experiences.seniority
Data Type: string
Premium: true
Description: Represents the level of seniority of the person within the company.
Example: C-Level+

Complete List

Experience: startedAt

Key: experiences.startedAt
Data Type: dateTime
Premium: true
Description: The date and time when the person began working at the company, in ISO 8601 format.
Example: 2020-08-12

Experience: endedAt

Key: experiences.endedAt
Data Type: dateTime
Premium: true
Description: The date and time when the person stopped working at the company, in ISO 8601 format.
Example: 2021-05-30

Educations

Key: educations
Data Type: Array of <education>
Description: An array of education objects representing the academic background of a person.
Example:

{
  "degree": "Postgraduate Certificate/Diploma",
  "institutionDivision": "Agriculture and Environmental Studies"
  "institutionDivisionDepartment": "Agricultural Science"
  "institutionLevel": "University",
  "institutionName": `University of Washington`,
  "startYear": 1999,
  "endYear": 2001
}

Education Degree

Key: education.degree
Data Type: string
Premium: true
Description: The degree or certification obtained by the individual.
Example: Postgraduate Certificate/Diploma

Complete List

Education Institution Division

Key: education.institutionDivision
Data Type: string
Premium: true
Description: The specific division or school within the educational institution.
Example: Fine Arts and Design

Complete List

Education Institution Division Department

Key: education.institutionDivisionDepartment
Data Type: string
Premium: true
Description: The department within the institution's division where the individual studied.
Example: Agricultural Science

Complete List

Education Institution Level

Key: education.institutionLevel
Data Type: string
Premium: true
Description: The level of the educational institution (e.g., University, College, High School).
Example: University

Complete List

Education Institution Name

Key: education.institutionName
Data Type: string
Premium: true
Description: The name of the educational institution attended.
Example: University of Washington

Education Start Year

Key: education.startYear
Data Type: string
Premium: true
Description: The year the individual began their studies at the institution.
Example: 1999

Education End Year

Key: education.endYear
Data Type: string
Premium: true
Description: The year the individual completed their studies at the institution.
Example: 2001

Example

{
  "id": "e7c2a3f458ef11edb8780242ac120002",
  "name": "Joe Doe",
  "firstName": "Joe",
  "lastName": "Doe",
  "photoUrl": "https://d1hbpr09pwz0sk.cloudfront.net/logourl/06f524f",
  "birthYear": 1988,
  "emails": [
    {
      "email": "[email protected]",
      "type": "professional",
      "lastValidatedAt": "2020-08-12T02:12:33.231Z",
      "scoreValue": 0.95
    }
  ],
  "phones": [
    {
      "phone": "+1234567890",
      "type": "mobile",
      "lastValidatedAt": "2020-08-12T02:12:33.231Z",
      "scoreValue": 0.90
    }
  ],
  "angellistUrl": "https://angel.co/joedoe",
  "crunchbaseUrl": "https://www.crunchbase.com/person/joedoe",
  "facebookUrl": "https://facebook.com/joedoe",
  "githubUrl": "https://github.com/joedoe",
  "linkedInUrl": "https://linkedin.com/in/joedoe",
  "xUrl": "https://twitter.com/joedoe",
  "youtubeUrl": "https://youtube.com/user/joedoe",
  "unitedStatesStateCode": "CA",
  "unitedStatesCity": "Seattle",
  "unitedStatesZipCode": "98119",
  "unitedStatesRegion": "West Coast",
  "countryCode": "US",
  "worldRegion": "Americas",
  "experiences": [
    {
      "id": "a1b2c3d4e5f611edb8780242ac120003",
      "name": "Acme Inc.",
      "department": "Engineering",
      "team": "Backend",
      "role": "Individual Contributor",
      "seniority": "Manager",
      "startedAt": "2018-06-15",
      "endedAt": "2022-11-30"
    }
  ],
  "educations": [
    {
      "degree": "Bachelor of Science",
      "institutionDivision": "Engineering",
      "institutionDivisionDepartment": "Computer Science",
      "institutionLevel": "University",
      "institutionName": "University of Washington",
      "startYear": "2006",
      "endYear": "2010"
    }
  ]
}

About​

Id​

Name​

First Name​

Last Name​

Photo Url​

Birth Year​

Contacts​

Emails​

Email​

Type​

Last Validated At​

Score Value​

Phones​

Phone​

Type​

Last Validated At​

Score Value​

Links​

Angellist URL​

Crunchbase URL​

Facebook URL​

Github URL​

LinkedIn URL​

X URL​

Youtube URL​

Location​

United States State Code​

United States City​

United States Zip Code​

United States Region​

Country Code​

World Region​

Experiences​

Experiences​

Experience: id​

Experience: name​

Experience: department​

Experience: team​

Experience: role​

Experience: seniority​

Experience: startedAt​

Experience: endedAt​

Educations​

Educations​

Education Degree​

Education Institution Division​

Education Institution Division Department​

Education Institution Level​

Education Institution Name​

Education Start Year​

Education End Year​

Example​

About

Id

Name

First Name

Last Name

Photo Url

Birth Year

Contacts

Emails

Email

Type

Last Validated At

Score Value

Phones

Phone

Type

Last Validated At

Score Value

Links

Angellist URL

Crunchbase URL

Facebook URL

Github URL

LinkedIn URL

X URL

Youtube URL

Location

United States State Code

United States City

United States Zip Code

United States Region

Country Code

World Region

Experiences

Experiences

Experience: id

Experience: name

Experience: department

Experience: team

Experience: role

Experience: seniority

Experience: startedAt

Experience: endedAt

Educations

Educations

Education Degree

Education Institution Division

Education Institution Division Department

Education Institution Level

Education Institution Name

Education Start Year

Education End Year

Example