Person Object Model

Key: person

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

About

Id

• Key: id
• Data Type: uuid
• Description: A universally unique identifier (UUID) compliant with RFC 4122, used to uniquely identify a person. 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

Links

Angellist URL

• Key: angellistUrl
• Data Type: url
• Premium: false
• Description: URL to an AngelList profile.
• Format: https://angel.co/[handle]
• Example: https://angel.co/joedoe

Crunchbase URL

• Key: crunchbaseUrl
• Data Type: url
• Premium: false
• Description: URL to a Crunchbase profile.
• Format: https://www.crunchbase.com/person/[handle]
• Example: https://www.crunchbase.com/person/joedoe

Facebook URL

• Key: facebookUrl
• Data Type: url
• Premium: false
• Description: URL to a Facebook profile.
• Format: https://facebook.com/[username]
• Example: https://facebook.com/joedoe

Github URL

• Key: githubUrl
• Data Type: url
• Premium: false
• Description: URL to a GitHub profile.
• Format: https://github.com/[username]
• Example: https://github.com/joedoe

LinkedIn URL

• Key: linkedInUrl
• Data Type: url
• Premium: false
• Description: URL to a LinkedIn profile.
• Format: https://linkedin.com/in/[handle]
• Example: https://linkedin.com/in/joedoe

X URL

• Key: xUrl
• Data Type: url
• Premium: false
• Description: URL to an X (Twitter) profile.
• Format: https://twitter.com/[username]
• Example: https://twitter.com/joedoe

Youtube URL

• Key: youtubeUrl
• Data Type: url
• Premium: false
• Description: URL to a YouTube channel.
• Format: https://youtube.com/user/[username]
• Example: https://youtube.com/user/joedoe

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

Experiences

• Key: experiences
• Data Type: Array of <object>
• Premium: false for current experience(s). true for previous experiences.
• Description: An array representing the work experiences of a person.
• Example:

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

note

Note that the current experience is included in basic, yet the job history is included in premium.

Experience: id

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

Experience: name

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

Experience: title

• Key: experiences.title
• Data Type: string
• Description: The user-reported job title at the company.
• Example: Senior Software Engineer

info

Note that since the Title is self-reported and not inferred by our AI, it might vary in length, contain spelling errors, or be inconsistent. For more structured and accurate data, we recommend using Department, Team, Role, and Seniority in combination.

Experience: department

• Key: experiences.department
• Data Type: string
• 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
• 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
• 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
• 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
• 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
• Description: The date and time when the person stopped working at the company, in ISO 8601 format.
• Example: 2021-05-30

Experience: isCurrent

• Key: experiences.isCurrent
• Data Type: boolean
• Description: Indicates whether this is the person's current position.
• Example: true

Educations

Educations

• Key: educations
• Data Type: Array of <object>
• Premium: true
• 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
• Description: The degree or certification obtained by the individual.
• Example: Postgraduate Certificate/Diploma

Complete List

Education Institution Division

• Key: education.institutionDivision
• Data Type: string
• 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
• 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
• 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
• Description: The name of the educational institution attended.
• Example: University of Washington

Education Start Year

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

Education End Year

• Key: education.endYear
• Data Type: string
• 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,  
  "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",
  "unitedStatesRegion": "West Coast",
  "countryCode": "US",
  "worldRegion": "Americas",
  "experiences": [
    {
      "id": "a1b2c3d4e5f611edb8780242ac120003",
      "name": "Acme Inc.",
      "title": "Senior Software Engineer",
      "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"
    }
  ]
}