API ReferencePerson

Enrich

Get enriched details on a person.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

idstringOptional
linkedinIDstringOptional
linkedinEntityIdstringOptional
LinkedIn entity ID
linkedinURLstringOptional

LinkedIn URL, accepts public profile (linkedin.com/in/), Sales Navigator, and Recruiter URLs

twitterIDstringOptional
crunchbaseIDstringOptional
angelListIDstringOptional
signalNfxIDstringOptional
polyworkIDstringOptional
emailstringOptional
rescrapebooleanOptional

Whether or not to automatically rescrape entities with stale data (specified by the maxDataAgeDays parameter).

maxDataAgeDaysintegerOptional

The threshold / amount of days to consider data stale and trigger an automatic rescrape (if supplied but rescrape parameter is false, expect a bad request error).

previewbooleanOptional

When true, returns only minimal identification info (id, name, URLs) without charging a credit.

fullbooleanOptional
When true, returns all relational data including company investments, fund investments, and founded companies.

Response

This endpoint returns an object.
certificationslist of objects
Ceritifcations that the person has listed.
computed_highlightListlist of strings
Highlights of the person, computed internally by Aviato
firstNamestring
The first name of the person
fullNamestring
The full name of the person
idstring
The Aviato ID of the person
investedIndustrieslist of strings
The industries that the person has invested in
investedRoundListlist of strings
The round stages the person has invested in
investorCategoryListlist of strings
The categories that the person has invested in
lastNamestring
The last name of the person
skillslist of strings
Skills that the person has listed.
URLsobject
All URLs associated with the person.
aboutstring
Short description about the person
companyInvestmentListlist of objects
List of company investments made by this person
degreeListlist of objects
List of degrees obtained by the person
educationListlist of objects
List of educational experiences
emailAvailableboolean
Whether at least one email address is available for this person
entityTypeenum

The type of entity the person is. This is always "person" for people.

Allowed values:
experienceListlist of objects
List of work experiences with company information
foundedCompanyListlist of objects
List of companies founded by this person
fundInvestmentListlist of objects
List of fund investments made by this person
genderstring
The gender of the person
headlinestring
Headline of the person.
investorCurrentFirmIDstring
The ID of the current firm the person is an investor at
investorDisinterestsstring
The disinterests of the person
investorFirmPositionstring
The position of the person at their current firm
investorInterestsstring
The interests of the person
investorMaxInvestmentdouble
The maximum investment the person is willing to make
investorMinInvestmentdouble
The minimum investment the person is willing to make
investorParticipatedRoundsCountinteger
The number of rounds the person has participated in
investorPreviousFirmIDstring
The ID of the previous firm the person was an investor at
investorPreviousFirmPositionstring
The position of the person at their previous firm
investorTargetInvestmentdouble
The target investment the person is looking for
investorTitlestring
The title of the person
investorTypestring
The type of investor the person is
languageListlist of objects
List of languages the person speaks
lastUpdateddatetime
The date this person was last updated, this is equivalent to a last scraped date.
linkedinConnectionsinteger
The number of connections the person has on LinkedIn
linkedinEntityIDstring

The entity ID of the person on LinkedIn, this is typically seen in Sales Navigator/Recruiter URLs.

linkedinFollowersinteger
The number of followers the person has on LinkedIn
linkedinIDstring

The ID of the person on LinkedIn, this is the bit that appears after /in/ in the profile URL. Also known as the “slug”, or “username”

linkedinJoinDatedatetime
The date the person joined LinkedIn.
linkedinLaborStatusenum

The labor status of the person (OPEN_TO_WORK, HIRING)

Allowed values:
linkedinNumIDstring
The numeric ID of the person on LinkedIn
linkedinOpenProfileboolean

Whether the person has an open LinkedIn profile (can be messaged without a connection)

linkedinPremiumboolean
Whether the person has a LinkedIn Premium subscription
locationstring
The location of the person.
locationDetailsobject
Detailed location information for the person
locationIDListlist of integers

All Geoencoded IDs of the locations the person is associated with. These IDs are typically used to quickly and efficiently filter people by location. Use the Geocoder Search endpoint to turn a location string into a Geocoded ID (https://docs.data.aviato.co/api-reference/geocoder/search)

personalEmailAvailableboolean
Whether at least one personal email address is available for this person
workEmailAvailableboolean
Whether at least one work email address is available for this person

Errors

400
Bad Request Error
401
Unauthorized Error
404
Person Not Found Error
429
Rate Limit Error