Enrich

GET

https://data.api.aviato.co/person/enrich

GET

/person/enrich

curl https://data.api.aviato.co/person/enrich \
     -H "Authorization: Bearer <token>"

{
  "certifications": [
    {
      "name": "name",
      "url": "url",
      "issued": "2024-01-15T09:30:00Z",
      "expires": "2024-01-15T09:30:00Z",
      "companyID": "companyID",
      "companyName": "companyName"
    },
    {
      "name": "name",
      "url": "url",
      "issued": "2024-01-15T09:30:00Z",
      "expires": "2024-01-15T09:30:00Z",
      "companyID": "companyID",
      "companyName": "companyName"
    }
  ],
  "computed_highlightList": [
    "computed_highlightList",
    "computed_highlightList"
  ],
  "firstName": "firstName",
  "fullName": "fullName",
  "id": "id",
  "investedIndustries": [
    "investedIndustries",
    "investedIndustries"
  ],
  "investedRoundList": [
    "investedRoundList",
    "investedRoundList"
  ],
  "investorCategoryList": [
    "investorCategoryList",
    "investorCategoryList"
  ],
  "lastName": "lastName",
  "skills": [
    "skills",
    "skills"
  ],
  "URLs": {
    "golden": "golden",
    "contact": "contact",
    "twitter": "twitter",
    "website": "website",
    "facebook": "facebook",
    "github": "github",
    "linkedin": "linkedin",
    "pitchbook": "pitchbook",
    "angelList": "angelList",
    "signalNFX": "signalNFX",
    "crunchbase": "crunchbase"
  },
  "about": "about",
  "companyInvestmentList": [
    {
      "id": 1,
      "company": {
        "id": "id",
        "name": "name",
        "description": "description",
        "country": "country",
        "region": "region",
        "locality": "locality",
        "URLs": {
          "golden": "golden",
          "contact": "contact",
          "twitter": "twitter",
          "website": "website",
          "facebook": "facebook",
          "github": "github",
          "linkedin": "linkedin",
          "pitchbook": "pitchbook",
          "angelList": "angelList",
          "signalNFX": "signalNFX",
          "crunchbase": "crunchbase"
        },
        "industryList": [
          "industryList",
          "industryList"
        ],
        "linkedinIndustries": [
          "linkedinIndustries",
          "linkedinIndustries"
        ],
        "headcount": 1,
        "computed_headcount": 1
      },
      "companyID": "companyID",
      "companyInvestorID": "companyInvestorID",
      "createdBy": "createdBy",
      "date": "2024-01-15T09:30:00Z",
      "personID": "personID",
      "totalAmountRaised": 1.1
    },
    {
      "id": 1,
      "company": {
        "id": "id",
        "name": "name",
        "description": "description",
        "country": "country",
        "region": "region",
        "locality": "locality",
        "URLs": {
          "golden": "golden",
          "contact": "contact",
          "twitter": "twitter",
          "website": "website",
          "facebook": "facebook",
          "github": "github",
          "linkedin": "linkedin",
          "pitchbook": "pitchbook",
          "angelList": "angelList",
          "signalNFX": "signalNFX",
          "crunchbase": "crunchbase"
        },
        "industryList": [
          "industryList",
          "industryList"
        ],
        "linkedinIndustries": [
          "linkedinIndustries",
          "linkedinIndustries"
        ],
        "headcount": 1,
        "computed_headcount": 1
      },
      "companyID": "companyID",
      "companyInvestorID": "companyInvestorID",
      "createdBy": "createdBy",
      "date": "2024-01-15T09:30:00Z",
      "personID": "personID",
      "totalAmountRaised": 1.1
    }
  ],
  "degreeList": [
    {
      "personID": "personID",
      "personEducationID": "personEducationID",
      "fieldOfStudy": "fieldOfStudy",
      "name": "name",
      "school": {
        "id": "id",
        "fullName": "fullName",
        "linkedinID": "linkedinID",
        "linkedinNumID": 1,
        "location": "location",
        "entityType": "person"
      }
    },
    {
      "personID": "personID",
      "personEducationID": "personEducationID",
      "fieldOfStudy": "fieldOfStudy",
      "name": "name",
      "school": {
        "id": "id",
        "fullName": "fullName",
        "linkedinID": "linkedinID",
        "linkedinNumID": 1,
        "location": "location",
        "entityType": "person"
      }
    }
  ],
  "educationList": [
    {
      "id": "id",
      "personID": "personID",
      "endDate": "2024-01-15T09:30:00Z",
      "startDate": "2024-01-15T09:30:00Z",
      "startDatePrecision": "YEAR",
      "endDatePrecision": "YEAR",
      "linkedinID": "linkedinID",
      "linkedinNumID": 1,
      "name": "name",
      "subject": "subject",
      "degreeName": "degreeName",
      "school": {
        "id": "id",
        "fullName": "fullName",
        "linkedinID": "linkedinID",
        "linkedinNumID": 1,
        "location": "location",
        "entityType": "person"
      },
      "grade": "grade",
      "activities": "activities",
      "personEducationID": 1
    },
    {
      "id": "id",
      "personID": "personID",
      "endDate": "2024-01-15T09:30:00Z",
      "startDate": "2024-01-15T09:30:00Z",
      "startDatePrecision": "YEAR",
      "endDatePrecision": "YEAR",
      "linkedinID": "linkedinID",
      "linkedinNumID": 1,
      "name": "name",
      "subject": "subject",
      "degreeName": "degreeName",
      "school": {
        "id": "id",
        "fullName": "fullName",
        "linkedinID": "linkedinID",
        "linkedinNumID": 1,
        "location": "location",
        "entityType": "person"
      },
      "grade": "grade",
      "activities": "activities",
      "personEducationID": 1
    }
  ],
  "emailAvailable": true,
  "entityType": "person",
  "experienceList": [
    {
      "personID": "personID",
      "positionList": [
        {
          "startDate": "startDate",
          "endDate": "2024-01-15T09:30:00Z",
          "startDatePrecision": "YEAR",
          "endDatePrecision": "YEAR",
          "title": "2024-01-15T09:30:00Z",
          "location": "location",
          "department": "department",
          "seniorityScore": 1,
          "description": "description",
          "employmentType": "FULL_TIME",
          "skills": [
            "skills",
            "skills"
          ]
        },
        {
          "startDate": "startDate",
          "endDate": "2024-01-15T09:30:00Z",
          "startDatePrecision": "YEAR",
          "endDatePrecision": "YEAR",
          "title": "2024-01-15T09:30:00Z",
          "location": "location",
          "department": "department",
          "seniorityScore": 1,
          "description": "description",
          "employmentType": "FULL_TIME",
          "skills": [
            "skills",
            "skills"
          ]
        }
      ],
      "company": {
        "id": "id",
        "name": "name",
        "description": "description",
        "country": "country",
        "region": "region",
        "locality": "locality",
        "URLs": {
          "golden": "golden",
          "contact": "contact",
          "twitter": "twitter",
          "website": "website",
          "facebook": "facebook",
          "github": "github",
          "linkedin": "linkedin",
          "pitchbook": "pitchbook",
          "angelList": "angelList",
          "signalNFX": "signalNFX",
          "crunchbase": "crunchbase"
        },
        "industryList": [
          "industryList",
          "industryList"
        ],
        "linkedinIndustries": [
          "linkedinIndustries",
          "linkedinIndustries"
        ],
        "headcount": 1,
        "computed_headcount": 1
      },
      "companyID": "companyID",
      "companyName": "companyName",
      "endDate": "2024-01-15T09:30:00Z",
      "endDatePrecision": "YEAR",
      "entityType": "person",
      "linkedinID": "linkedinID",
      "linkedinNumID": "linkedinNumID",
      "startDate": "2024-01-15T09:30:00Z",
      "startDatePrecision": "YEAR"
    },
    {
      "personID": "personID",
      "positionList": [
        {
          "startDate": "startDate",
          "endDate": "2024-01-15T09:30:00Z",
          "startDatePrecision": "YEAR",
          "endDatePrecision": "YEAR",
          "title": "2024-01-15T09:30:00Z",
          "location": "location",
          "department": "department",
          "seniorityScore": 1,
          "description": "description",
          "employmentType": "FULL_TIME",
          "skills": [
            "skills",
            "skills"
          ]
        },
        {
          "startDate": "startDate",
          "endDate": "2024-01-15T09:30:00Z",
          "startDatePrecision": "YEAR",
          "endDatePrecision": "YEAR",
          "title": "2024-01-15T09:30:00Z",
          "location": "location",
          "department": "department",
          "seniorityScore": 1,
          "description": "description",
          "employmentType": "FULL_TIME",
          "skills": [
            "skills",
            "skills"
          ]
        }
      ],
      "company": {
        "id": "id",
        "name": "name",
        "description": "description",
        "country": "country",
        "region": "region",
        "locality": "locality",
        "URLs": {
          "golden": "golden",
          "contact": "contact",
          "twitter": "twitter",
          "website": "website",
          "facebook": "facebook",
          "github": "github",
          "linkedin": "linkedin",
          "pitchbook": "pitchbook",
          "angelList": "angelList",
          "signalNFX": "signalNFX",
          "crunchbase": "crunchbase"
        },
        "industryList": [
          "industryList",
          "industryList"
        ],
        "linkedinIndustries": [
          "linkedinIndustries",
          "linkedinIndustries"
        ],
        "headcount": 1,
        "computed_headcount": 1
      },
      "companyID": "companyID",
      "companyName": "companyName",
      "endDate": "2024-01-15T09:30:00Z",
      "endDatePrecision": "YEAR",
      "entityType": "person",
      "linkedinID": "linkedinID",
      "linkedinNumID": "linkedinNumID",
      "startDate": "2024-01-15T09:30:00Z",
      "startDatePrecision": "YEAR"
    }
  ],
  "foundedCompanyList": [
    {
      "id": "id",
      "name": "name",
      "description": "description",
      "country": "country",
      "region": "region",
      "locality": "locality",
      "URLs": {
        "golden": "golden",
        "contact": "contact",
        "twitter": "twitter",
        "website": "website",
        "facebook": "facebook",
        "github": "github",
        "linkedin": "linkedin",
        "pitchbook": "pitchbook",
        "angelList": "angelList",
        "signalNFX": "signalNFX",
        "crunchbase": "crunchbase"
      },
      "industryList": [
        "industryList",
        "industryList"
      ],
      "linkedinIndustries": [
        "linkedinIndustries",
        "linkedinIndustries"
      ],
      "headcount": 1,
      "computed_headcount": 1
    },
    {
      "id": "id",
      "name": "name",
      "description": "description",
      "country": "country",
      "region": "region",
      "locality": "locality",
      "URLs": {
        "golden": "golden",
        "contact": "contact",
        "twitter": "twitter",
        "website": "website",
        "facebook": "facebook",
        "github": "github",
        "linkedin": "linkedin",
        "pitchbook": "pitchbook",
        "angelList": "angelList",
        "signalNFX": "signalNFX",
        "crunchbase": "crunchbase"
      },
      "industryList": [
        "industryList",
        "industryList"
      ],
      "linkedinIndustries": [
        "linkedinIndustries",
        "linkedinIndustries"
      ],
      "headcount": 1,
      "computed_headcount": 1
    }
  ],
  "fundInvestmentList": [
    {
      "id": 1,
      "companyInvestorList": [
        {
          "id": "id",
          "name": "name",
          "description": "description",
          "country": "country",
          "region": "region",
          "locality": "locality",
          "URLs": {
            "golden": "golden",
            "contact": "contact",
            "twitter": "twitter",
            "website": "website",
            "facebook": "facebook",
            "github": "github",
            "linkedin": "linkedin",
            "pitchbook": "pitchbook",
            "angelList": "angelList",
            "signalNFX": "signalNFX",
            "crunchbase": "crunchbase"
          },
          "industryList": [
            "industryList",
            "industryList"
          ],
          "linkedinIndustries": [
            "linkedinIndustries",
            "linkedinIndustries"
          ],
          "headcount": 1,
          "computed_headcount": 1
        },
        {
          "id": "id",
          "name": "name",
          "description": "description",
          "country": "country",
          "region": "region",
          "locality": "locality",
          "URLs": {
            "golden": "golden",
            "contact": "contact",
            "twitter": "twitter",
            "website": "website",
            "facebook": "facebook",
            "github": "github",
            "linkedin": "linkedin",
            "pitchbook": "pitchbook",
            "angelList": "angelList",
            "signalNFX": "signalNFX",
            "crunchbase": "crunchbase"
          },
          "industryList": [
            "industryList",
            "industryList"
          ],
          "linkedinIndustries": [
            "linkedinIndustries",
            "linkedinIndustries"
          ],
          "headcount": 1,
          "computed_headcount": 1
        }
      ],
      "personInvestorList": [
        {
          "id": "id",
          "fullName": "fullName",
          "firstName": "firstName",
          "lastName": "lastName",
          "entityType": "person",
          "location": "location",
          "URLs": {
            "golden": "golden",
            "contact": "contact",
            "twitter": "twitter",
            "website": "website",
            "facebook": "facebook",
            "github": "github",
            "linkedin": "linkedin",
            "pitchbook": "pitchbook",
            "angelList": "angelList",
            "signalNFX": "signalNFX",
            "crunchbase": "crunchbase"
          }
        },
        {
          "id": "id",
          "fullName": "fullName",
          "firstName": "firstName",
          "lastName": "lastName",
          "entityType": "person",
          "location": "location",
          "URLs": {
            "golden": "golden",
            "contact": "contact",
            "twitter": "twitter",
            "website": "website",
            "facebook": "facebook",
            "github": "github",
            "linkedin": "linkedin",
            "pitchbook": "pitchbook",
            "angelList": "angelList",
            "signalNFX": "signalNFX",
            "crunchbase": "crunchbase"
          }
        }
      ],
      "name": "name",
      "date": "2024-01-15T09:30:00Z",
      "amountRaised": 1.1
    },
    {
      "id": 1,
      "companyInvestorList": [
        {
          "id": "id",
          "name": "name",
          "description": "description",
          "country": "country",
          "region": "region",
          "locality": "locality",
          "URLs": {
            "golden": "golden",
            "contact": "contact",
            "twitter": "twitter",
            "website": "website",
            "facebook": "facebook",
            "github": "github",
            "linkedin": "linkedin",
            "pitchbook": "pitchbook",
            "angelList": "angelList",
            "signalNFX": "signalNFX",
            "crunchbase": "crunchbase"
          },
          "industryList": [
            "industryList",
            "industryList"
          ],
          "linkedinIndustries": [
            "linkedinIndustries",
            "linkedinIndustries"
          ],
          "headcount": 1,
          "computed_headcount": 1
        },
        {
          "id": "id",
          "name": "name",
          "description": "description",
          "country": "country",
          "region": "region",
          "locality": "locality",
          "URLs": {
            "golden": "golden",
            "contact": "contact",
            "twitter": "twitter",
            "website": "website",
            "facebook": "facebook",
            "github": "github",
            "linkedin": "linkedin",
            "pitchbook": "pitchbook",
            "angelList": "angelList",
            "signalNFX": "signalNFX",
            "crunchbase": "crunchbase"
          },
          "industryList": [
            "industryList",
            "industryList"
          ],
          "linkedinIndustries": [
            "linkedinIndustries",
            "linkedinIndustries"
          ],
          "headcount": 1,
          "computed_headcount": 1
        }
      ],
      "personInvestorList": [
        {
          "id": "id",
          "fullName": "fullName",
          "firstName": "firstName",
          "lastName": "lastName",
          "entityType": "person",
          "location": "location",
          "URLs": {
            "golden": "golden",
            "contact": "contact",
            "twitter": "twitter",
            "website": "website",
            "facebook": "facebook",
            "github": "github",
            "linkedin": "linkedin",
            "pitchbook": "pitchbook",
            "angelList": "angelList",
            "signalNFX": "signalNFX",
            "crunchbase": "crunchbase"
          }
        },
        {
          "id": "id",
          "fullName": "fullName",
          "firstName": "firstName",
          "lastName": "lastName",
          "entityType": "person",
          "location": "location",
          "URLs": {
            "golden": "golden",
            "contact": "contact",
            "twitter": "twitter",
            "website": "website",
            "facebook": "facebook",
            "github": "github",
            "linkedin": "linkedin",
            "pitchbook": "pitchbook",
            "angelList": "angelList",
            "signalNFX": "signalNFX",
            "crunchbase": "crunchbase"
          }
        }
      ],
      "name": "name",
      "date": "2024-01-15T09:30:00Z",
      "amountRaised": 1.1
    }
  ],
  "gender": "gender",
  "headline": "headline",
  "investorCurrentFirmID": "investorCurrentFirmID",
  "investorDisinterests": "investorDisinterests",
  "investorFirmPosition": "investorFirmPosition",
  "investorInterests": "investorInterests",
  "investorMaxInvestment": 1.1,
  "investorMinInvestment": 1.1,
  "investorParticipatedRoundsCount": 1,
  "investorPreviousFirmID": "investorPreviousFirmID",
  "investorPreviousFirmPosition": "investorPreviousFirmPosition",
  "investorTargetInvestment": 1.1,
  "investorTitle": "investorTitle",
  "investorType": "investorType",
  "languageList": [
    {
      "languageName": "languageName",
      "proficiency": "ELEMENTARY"
    },
    {
      "languageName": "languageName",
      "proficiency": "ELEMENTARY"
    }
  ],
  "lastUpdated": "2024-01-15T09:30:00Z",
  "linkedinConnections": 1,
  "linkedinEntityID": "linkedinEntityID",
  "linkedinFollowers": 1,
  "linkedinID": "linkedinID",
  "linkedinNumID": "linkedinNumID",
  "location": "location",
  "locationDetails": {
    "continent": {
      "id": 1,
      "name": "name",
      "placeType": "placeType",
      "geometry": {
        "area_square_degrees": 1.1,
        "bbox": "bbox",
        "lat": 1.1,
        "lon": 1.1
      }
    },
    "country": {
      "id": 1,
      "name": "name",
      "placeType": "placeType",
      "geometry": {
        "area_square_degrees": 1.1,
        "bbox": "bbox",
        "lat": 1.1,
        "lon": 1.1
      }
    },
    "county": {
      "id": 1,
      "name": "name",
      "placeType": "placeType",
      "geometry": {
        "area_square_degrees": 1.1,
        "bbox": "bbox",
        "lat": 1.1,
        "lon": 1.1
      }
    },
    "localadmin": {
      "id": 1,
      "name": "name",
      "placeType": "placeType",
      "geometry": {
        "area_square_degrees": 1.1,
        "bbox": "bbox",
        "lat": 1.1,
        "lon": 1.1
      }
    },
    "locality": {
      "id": 1,
      "name": "name",
      "placeType": "placeType",
      "geometry": {
        "area_square_degrees": 1.1,
        "bbox": "bbox",
        "lat": 1.1,
        "lon": 1.1
      }
    },
    "borough": {
      "id": 1,
      "name": "name",
      "placeType": "placeType",
      "geometry": {
        "area_square_degrees": 1.1,
        "bbox": "bbox",
        "lat": 1.1,
        "lon": 1.1
      }
    },
    "macroregion": {
      "id": 1,
      "name": "name",
      "placeType": "placeType",
      "geometry": {
        "area_square_degrees": 1.1,
        "bbox": "bbox",
        "lat": 1.1,
        "lon": 1.1
      }
    },
    "region": {
      "id": 1,
      "name": "name",
      "placeType": "placeType",
      "geometry": {
        "area_square_degrees": 1.1,
        "bbox": "bbox",
        "lat": 1.1,
        "lon": 1.1
      }
    },
    "macrohood": {
      "id": 1,
      "name": "name",
      "placeType": "placeType",
      "geometry": {
        "area_square_degrees": 1.1,
        "bbox": "bbox",
        "lat": 1.1,
        "lon": 1.1
      }
    },
    "neighbourhood": {
      "id": 1,
      "name": "name",
      "placeType": "placeType",
      "geometry": {
        "area_square_degrees": 1.1,
        "bbox": "bbox",
        "lat": 1.1,
        "lon": 1.1
      }
    }
  },
  "locationIDList": [
    1,
    1
  ],
  "personalEmailAvailable": true,
  "workEmailAvailable": true
}

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 public profile URL (linkedin.com/in/)

twitterIDstringOptional

crunchbaseIDstringOptional

angelListIDstringOptional

signalNfxIDstringOptional

polyworkIDstringOptional

emailstringOptional

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.

requirelist of stringsOptional

List of top-level response fields that must each have a non-empty value, otherwise a 404 is returned and no credit is charged. Example: ?require=fullName&require=URLs. Ignored when preview=true.

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.

URLsobjectOptional

All URLs associated with the person.

aboutstringOptional

Short description about the person

companyInvestmentListlist of objectsOptional

List of company investments made by this person

degreeListlist of objectsOptional

List of degrees obtained by the person

educationListlist of objectsOptional

List of educational experiences

emailAvailablebooleanOptional

Whether at least one email address is available for this person

entityTypeenumOptional

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

Allowed values:

experienceListlist of objectsOptional

List of work experiences with company information

foundedCompanyListlist of objectsOptional

List of companies founded by this person

fundInvestmentListlist of objectsOptional

List of fund investments made by this person

genderstringOptional

The gender of the person

headlinestringOptional

Headline of the person.

investorCurrentFirmIDstringOptional

The ID of the current firm the person is an investor at

investorDisinterestsstringOptional

The disinterests of the person

investorFirmPositionstringOptional

The position of the person at their current firm

investorInterestsstringOptional

The interests of the person

investorMaxInvestmentdoubleOptional

The maximum investment the person is willing to make

investorMinInvestmentdoubleOptional

The minimum investment the person is willing to make

investorParticipatedRoundsCountintegerOptional

The number of rounds the person has participated in

investorPreviousFirmIDstringOptional

The ID of the previous firm the person was an investor at

investorPreviousFirmPositionstringOptional

The position of the person at their previous firm

investorTargetInvestmentdoubleOptional

The target investment the person is looking for

investorTitlestringOptional

The title of the person

investorTypestringOptional

The type of investor the person is

languageListlist of objectsOptional

List of languages the person speaks

lastUpdateddatetimeOptional

The date this person's data was last updated.

linkedinConnectionsintegerOptional

The number of connections the person has on LinkedIn

linkedinEntityIDstringOptional

The LinkedIn entity ID of the person.

linkedinFollowersintegerOptional

The number of followers the person has on LinkedIn

linkedinIDstringOptional

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”

linkedinNumIDstringOptional

The numeric ID of the person on LinkedIn

locationstringOptional

The location of the person.

locationDetailsobjectOptional

Detailed location information for the person

locationIDListlist of integersOptional

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)

personalEmailAvailablebooleanOptional

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

workEmailAvailablebooleanOptional

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