> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Aviato Person Bulk Enrich: Inputs, Cost & CLI Example
> Get enriched details on multiple people at once. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=aviato_person_bulk_enrich:{"lookups":"{{lookups}}"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ------------------------ | --------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.lookups` | `array` | Yes | | |
| `payload.rescrape` | `boolean` | No | | Whether or not to automatically rescrape entities with stale data (specified by the maxDataAgeDays parameter). |
| `payload.maxDataAgeDays` | `integer` | No | | 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). |
| `payload.preview` | `boolean` | No | | When true, returns only minimal identification info (id, name, URLs) without charging credits. |
| `payload.require` | `array` | No | | List of top-level response fields that must each have a non-empty value on a given lookup. Lookups that don't satisfy this gate are returned with `lookupSuccessful=false` and are not billed. Ignored when `preview=true`. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Get enriched details on multiple people at once. Max 20 at a time",
"properties": {
"lookups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"linkedinID": {
"type": "string"
},
"linkedinEntityId": {
"type": "string",
"description": "LinkedIn entity ID"
},
"linkedinURL": {
"type": "string",
"description": "LinkedIn URL, accepts public profile (linkedin.com/in/), Sales Navigator, and Recruiter URLs"
},
"twitterID": {
"type": "string"
},
"crunchbaseID": {
"type": "string"
},
"angelListID": {
"type": "string"
},
"signalNfxID": {
"type": "string"
},
"polyworkID": {
"type": "string"
},
"email": {
"type": "string"
}
},
"additionalProperties": false
}
},
"rescrape": {
"type": "boolean",
"description": "Whether or not to automatically rescrape entities with stale data (specified by the maxDataAgeDays parameter)."
},
"maxDataAgeDays": {
"type": "integer",
"description": "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)."
},
"preview": {
"type": "boolean",
"description": "When true, returns only minimal identification info (id, name, URLs) without charging credits."
},
"require": {
"type": "array",
"description": "List of top-level response fields that must each have a non-empty value on a given lookup. Lookups that don't satisfy this gate are returned with `lookupSuccessful=false` and are not billed. Ignored when `preview=true`.",
"items": {
"type": "string"
}
}
},
"required": [
"lookups"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `array` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "array",
"description": "Provider response payload.",
"items": {
"type": "object",
"properties": {
"person": {
"type": "object",
"description": "Extended Version of Person object, includes some relational fields, if you request for them to be included in the results.",
"properties": {
"id": {
"type": "string",
"description": "The Aviato ID of the person"
},
"fullName": {
"type": "string",
"description": "The full name of the person"
},
"firstName": {
"type": "string",
"description": "The first name of the person"
},
"lastName": {
"type": "string",
"description": "The last name of the person"
},
"entityType": {
"type": "string",
"enum": [
"person",
"company",
"school",
"organization"
]
},
"location": {
"type": "string",
"description": "The location of the person."
},
"URLs": {
"type": "object",
"description": "This object represents different urls that can be associated with any type of entity. (Does not include http prefix)",
"properties": {
"golden": {
"type": "string"
},
"contact": {
"type": "string"
},
"twitter": {
"type": "string"
},
"website": {
"type": "string"
},
"facebook": {
"type": "string"
},
"github": {
"type": "string"
},
"linkedin": {
"type": "string"
},
"pitchbook": {
"type": "string"
},
"angelList": {
"type": "string"
},
"signalNFX": {
"type": "string"
},
"crunchbase": {
"type": "string"
}
},
"additionalProperties": false
},
"about": {
"type": "string",
"description": "Short description about the person"
},
"headline": {
"type": "string",
"description": "Headline of the person."
},
"skills": {
"type": "array",
"description": "Skills that the person has listed.",
"items": {
"type": "string"
}
},
"certifications": {
"type": "array",
"description": "Ceritifcations that the person has listed.",
"items": {
"type": "object",
"description": "A Certification issued by a company attributed to a person.",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"issued": {
"type": "string",
"format": "date-time"
},
"expires": {
"type": "string",
"format": "date-time"
},
"companyID": {
"type": "string"
},
"companyName": {
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"gender": {
"type": "string",
"description": "The gender of the person"
},
"linkedinID": {
"type": "string",
"description": "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\""
},
"linkedinNumID": {
"type": "string",
"description": "The numeric ID of the person on LinkedIn"
},
"linkedinEntityID": {
"type": "string",
"description": "The entity ID of the person on LinkedIn, this is typically seen in Sales Navigator/Recruiter URLs."
},
"investedRoundList": {
"type": "array",
"description": "The round stages the person has invested in",
"items": {
"type": "string"
}
},
"investedIndustries": {
"type": "array",
"description": "The industries that the person has invested in",
"items": {
"type": "string"
}
},
"investorCategoryList": {
"type": "array",
"description": "The categories that the person has invested in",
"items": {
"type": "string"
}
},
"investorCurrentFirmID": {
"type": "string",
"description": "The ID of the current firm the person is an investor at"
},
"investorDisinterests": {
"type": "string",
"description": "The disinterests of the person"
},
"investorFirmPosition": {
"type": "string",
"description": "The position of the person at their current firm"
},
"investorInterests": {
"type": "string",
"description": "The interests of the person"
},
"investorMaxInvestment": {
"type": "number",
"description": "The maximum investment the person is willing to make",
"format": "double"
},
"investorMinInvestment": {
"type": "number",
"description": "The minimum investment the person is willing to make",
"format": "double"
},
"investorParticipatedRoundsCount": {
"type": "integer",
"description": "The number of rounds the person has participated in"
},
"investorPreviousFirmID": {
"type": "string",
"description": "The ID of the previous firm the person was an investor at"
},
"investorPreviousFirmPosition": {
"type": "string",
"description": "The position of the person at their previous firm"
},
"investorTargetInvestment": {
"type": "number",
"description": "The target investment the person is looking for",
"format": "double"
},
"investorTitle": {
"type": "string",
"description": "The title of the person"
},
"investorType": {
"type": "string",
"description": "The type of investor the person is"
},
"computed_highlightList": {
"type": "array",
"description": "Highlights of the person, computed internally by Aviato",
"items": {
"type": "string"
}
},
"lastUpdated": {
"type": "string",
"description": "The date this person was last updated, this is equivalent to a last scraped date.",
"format": "date-time"
},
"locationIDList": {
"type": "array",
"description": "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)",
"items": {
"type": "integer"
}
},
"linkedinConnections": {
"type": "integer",
"description": "The number of connections the person has on LinkedIn"
},
"linkedinFollowers": {
"type": "integer",
"description": "The number of followers the person has on LinkedIn"
},
"linkedinOpenProfile": {
"type": "boolean",
"description": "Whether the person has an open LinkedIn profile (can be messaged without a connection)"
},
"linkedinPremium": {
"type": "boolean",
"description": "Whether the person has a LinkedIn Premium subscription"
},
"linkedinLaborStatus": {
"type": "string",
"description": "The labor status of a person on LinkedIn",
"enum": [
"OPEN_TO_WORK",
"HIRING"
]
},
"linkedinJoinDate": {
"type": "string",
"description": "The date the person joined LinkedIn.",
"format": "date-time"
},
"experienceList": {
"type": "array",
"description": "List of work experiences with company information",
"items": {
"type": "object",
"description": "This object represents a person's experience working at a company. It includes the positions that were held at the given company. It also includes the starting and ending date of their time at the company (ending date is undefined if the position has not yet ended). It also includes some basic information about the company like name and industryList. There are times when companyName is defined but company.name is undefined. This can occur if we do not have their company in our database.",
"properties": {
"endDate": {
"type": "string",
"description": "The end date of the work experience, will be null if ongoing.",
"format": "date-time"
},
"startDate": {
"type": "string",
"description": "The start date of the work experience",
"format": "date-time"
},
"linkedinNumID": {
"type": "string",
"description": "The numeric ID of the company on LinkedIn"
},
"linkedinID": {
"type": "string",
"description": "The LinkedIn ID of the company associated with this work experience"
},
"entityType": {
"type": "string",
"enum": [
"person",
"company",
"school",
"organization"
]
},
"positionList": {
"type": "array",
"description": "List of positions held during this work experience",
"items": {
"type": "object",
"description": "This object represents a position held at a given company. It includes the starting and ending date of the position, (ending date is undefined if the position has not yet ended). And it also includes the title of the position.",
"properties": {
"startDate": {
"type": "string",
"description": "The start date of the position"
},
"endDate": {
"type": "string",
"description": "The end date of the position, will be null if ongoing.",
"format": "date-time"
},
"title": {
"type": "string",
"description": "The job title of the position",
"format": "date-time"
},
"location": {
"type": "string",
"description": "The location of the position"
},
"department": {
"type": "string",
"description": "The department of the position"
},
"seniorityScore": {
"type": "integer",
"description": "The seniority score of the position (1-7)"
},
"description": {
"type": "string",
"description": "Description of position as provided by the person"
}
},
"additionalProperties": false
}
},
"personID": {
"type": "string",
"description": "The ID of the person who had this work experience"
},
"companyID": {
"type": "string",
"description": "The ID of the company where the person worked"
},
"companyName": {
"type": "string",
"description": "The name of the company where the person worked"
},
"company": {
"type": "object",
"description": "This object represents a company. It includes only the most essential information to identify a company.",
"properties": {
"id": {
"type": "string",
"description": "The Aviato ID of the company"
},
"name": {
"type": "string",
"description": "The name of the company"
},
"description": {
"type": "string",
"description": "Description of the company"
},
"country": {
"type": "string",
"description": "The country of the company (Full country name)"
},
"region": {
"type": "string",
"description": "The region of the company (state/province)"
},
"locality": {
"type": "string",
"description": "The locality of the company (city/town/village)"
},
"URLs": {
"type": "object",
"description": "This object represents different urls that can be associated with any type of entity. (Does not include http prefix)",
"properties": {
"golden": {
"type": "string"
},
"contact": {
"type": "string"
},
"twitter": {
"type": "string"
},
"website": {
"type": "string"
},
"facebook": {
"type": "string"
},
"github": {
"type": "string"
},
"linkedin": {
"type": "string"
},
"pitchbook": {
"type": "string"
},
"angelList": {
"type": "string"
},
"signalNFX": {
"type": "string"
},
"crunchbase": {
"type": "string"
}
},
"additionalProperties": false
},
"industryList": {
"type": "array",
"description": "The industries the company is associated with.",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"additionalProperties": false
}
},
"required": [
"positionList",
"personID"
],
"additionalProperties": false
}
},
"educationList": {
"type": "array",
"description": "List of educational experiences",
"items": {
"type": "object",
"description": "This object represents an education that was obtained by a person at a school",
"properties": {
"id": {
"type": "string",
"description": "The unique identifier of the education record"
},
"endDate": {
"type": "string",
"description": "The end date of the education period, will be null if ongoing.",
"format": "date-time"
},
"startDate": {
"type": "string",
"description": "The start date of the education period",
"format": "date-time"
},
"linkedinID": {
"type": "string",
"description": "The LinkedIn ID associated with this education"
},
"name": {
"type": "string",
"description": "The name or title of the education/degree"
},
"subject": {
"type": "string",
"description": "The subject or field of study"
},
"school": {
"type": "object",
"description": "This object represents a school.",
"properties": {
"id": {
"type": "string",
"description": "The unique Aviato identifier of the school"
},
"linkedinID": {
"type": "string",
"description": "The LinkedIn ID of the school"
},
"fullName": {
"type": "string",
"description": "The full name of the school"
},
"location": {
"type": "string",
"description": "The location of the school"
},
"entityType": {
"type": "string",
"enum": [
"person",
"company",
"school",
"organization"
]
}
},
"required": [
"id",
"fullName"
],
"additionalProperties": false
},
"grade": {
"type": "string",
"description": "The grade associated with this education"
},
"activities": {
"type": "string",
"description": "Extra-curricular activities / societies associated with this education"
},
"personID": {
"type": "string",
"description": "The ID of the person who obtained this education"
},
"personEducationID": {
"type": "integer",
"description": "The education ID specific to the person"
}
},
"required": [
"id",
"personID"
],
"additionalProperties": false
}
},
"degreeList": {
"type": "array",
"description": "List of degrees obtained by the person",
"items": {
"type": "object",
"description": "This object represents a degree obtained by a person. It includes the school at which the degree was obtained, along with then name, and field of study of their degree. The personEducationID tell you which education the degree is associated with.",
"properties": {
"personEducationID": {
"type": "string",
"description": "The education ID this degree belongs to"
},
"fieldOfStudy": {
"type": "string",
"description": "The field of study for the degree"
},
"name": {
"type": "string",
"description": "The name or title of the degree"
},
"school": {
"type": "object",
"description": "This object represents a school.",
"properties": {
"id": {
"type": "string",
"description": "The unique Aviato identifier of the school"
},
"linkedinID": {
"type": "string",
"description": "The LinkedIn ID of the school"
},
"fullName": {
"type": "string",
"description": "The full name of the school"
},
"location": {
"type": "string",
"description": "The location of the school"
},
"entityType": {
"type": "string",
"enum": [
"person",
"company",
"school",
"organization"
]
}
},
"required": [
"id",
"fullName"
],
"additionalProperties": false
},
"personID": {
"type": "string",
"description": "The ID of the person who obtained this degree"
}
},
"required": [
"personID"
],
"additionalProperties": false
}
},
"locationDetails": {
"type": "object",
"description": "This object represents the detailed location data of the entity. The below placetypes are the only placetypes that we support in the Who's On First gazetter. The returned IDs are valid Who's On First location ids. See [https://github.com/whosonfirst/whosonfirst-placetypes](this page) for a detailed description of the various placetypes",
"properties": {
"continent": {
"type": "object",
"description": "Represents a geographic place with its location details",
"properties": {
"id": {
"type": "integer",
"description": "The Geocoded location ID"
},
"name": {
"type": "string",
"description": "The name of the place"
},
"placeType": {
"type": "string",
"description": "The type of place (locality, region, country, etc.)"
},
"geometry": {
"type": "object",
"description": "Geographic geometry data for a location",
"properties": {
"area_square_degrees": {
"type": "number",
"description": "The area of the location in square degrees",
"format": "double"
},
"bbox": {
"type": "string",
"description": "The bounding box coordinates of the location"
},
"lat": {
"type": "number",
"description": "The latitude coordinate",
"format": "double"
},
"lon": {
"type": "number",
"description": "The longitude coordinate",
"format": "double"
}
},
"required": [
"area_square_degrees",
"bbox",
"lat",
"lon"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"placeType",
"geometry"
],
"additionalProperties": false
},
"country": {
"type": "object",
"description": "Represents a geographic place with its location details",
"properties": {
"id": {
"type": "integer",
"description": "The Geocoded location ID"
},
"name": {
"type": "string",
"description": "The name of the place"
},
"placeType": {
"type": "string",
"description": "The type of place (locality, region, country, etc.)"
},
"geometry": {
"type": "object",
"description": "Geographic geometry data for a location",
"properties": {
"area_square_degrees": {
"type": "number",
"description": "The area of the location in square degrees",
"format": "double"
},
"bbox": {
"type": "string",
"description": "The bounding box coordinates of the location"
},
"lat": {
"type": "number",
"description": "The latitude coordinate",
"format": "double"
},
"lon": {
"type": "number",
"description": "The longitude coordinate",
"format": "double"
}
},
"required": [
"area_square_degrees",
"bbox",
"lat",
"lon"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"placeType",
"geometry"
],
"additionalProperties": false
},
"county": {
"type": "object",
"description": "Represents a geographic place with its location details",
"properties": {
"id": {
"type": "integer",
"description": "The Geocoded location ID"
},
"name": {
"type": "string",
"description": "The name of the place"
},
"placeType": {
"type": "string",
"description": "The type of place (locality, region, country, etc.)"
},
"geometry": {
"type": "object",
"description": "Geographic geometry data for a location",
"properties": {
"area_square_degrees": {
"type": "number",
"description": "The area of the location in square degrees",
"format": "double"
},
"bbox": {
"type": "string",
"description": "The bounding box coordinates of the location"
},
"lat": {
"type": "number",
"description": "The latitude coordinate",
"format": "double"
},
"lon": {
"type": "number",
"description": "The longitude coordinate",
"format": "double"
}
},
"required": [
"area_square_degrees",
"bbox",
"lat",
"lon"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"placeType",
"geometry"
],
"additionalProperties": false
},
"localadmin": {
"type": "object",
"description": "Represents a geographic place with its location details",
"properties": {
"id": {
"type": "integer",
"description": "The Geocoded location ID"
},
"name": {
"type": "string",
"description": "The name of the place"
},
"placeType": {
"type": "string",
"description": "The type of place (locality, region, country, etc.)"
},
"geometry": {
"type": "object",
"description": "Geographic geometry data for a location",
"properties": {
"area_square_degrees": {
"type": "number",
"description": "The area of the location in square degrees",
"format": "double"
},
"bbox": {
"type": "string",
"description": "The bounding box coordinates of the location"
},
"lat": {
"type": "number",
"description": "The latitude coordinate",
"format": "double"
},
"lon": {
"type": "number",
"description": "The longitude coordinate",
"format": "double"
}
},
"required": [
"area_square_degrees",
"bbox",
"lat",
"lon"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"placeType",
"geometry"
],
"additionalProperties": false
},
"locality": {
"type": "object",
"description": "Represents a geographic place with its location details",
"properties": {
"id": {
"type": "integer",
"description": "The Geocoded location ID"
},
"name": {
"type": "string",
"description": "The name of the place"
},
"placeType": {
"type": "string",
"description": "The type of place (locality, region, country, etc.)"
},
"geometry": {
"type": "object",
"description": "Geographic geometry data for a location",
"properties": {
"area_square_degrees": {
"type": "number",
"description": "The area of the location in square degrees",
"format": "double"
},
"bbox": {
"type": "string",
"description": "The bounding box coordinates of the location"
},
"lat": {
"type": "number",
"description": "The latitude coordinate",
"format": "double"
},
"lon": {
"type": "number",
"description": "The longitude coordinate",
"format": "double"
}
},
"required": [
"area_square_degrees",
"bbox",
"lat",
"lon"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"placeType",
"geometry"
],
"additionalProperties": false
},
"borough": {
"type": "object",
"description": "Represents a geographic place with its location details",
"properties": {
"id": {
"type": "integer",
"description": "The Geocoded location ID"
},
"name": {
"type": "string",
"description": "The name of the place"
},
"placeType": {
"type": "string",
"description": "The type of place (locality, region, country, etc.)"
},
"geometry": {
"type": "object",
"description": "Geographic geometry data for a location",
"properties": {
"area_square_degrees": {
"type": "number",
"description": "The area of the location in square degrees",
"format": "double"
},
"bbox": {
"type": "string",
"description": "The bounding box coordinates of the location"
},
"lat": {
"type": "number",
"description": "The latitude coordinate",
"format": "double"
},
"lon": {
"type": "number",
"description": "The longitude coordinate",
"format": "double"
}
},
"required": [
"area_square_degrees",
"bbox",
"lat",
"lon"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"placeType",
"geometry"
],
"additionalProperties": false
},
"macroregion": {
"type": "object",
"description": "Represents a geographic place with its location details",
"properties": {
"id": {
"type": "integer",
"description": "The Geocoded location ID"
},
"name": {
"type": "string",
"description": "The name of the place"
},
"placeType": {
"type": "string",
"description": "The type of place (locality, region, country, etc.)"
},
"geometry": {
"type": "object",
"description": "Geographic geometry data for a location",
"properties": {
"area_square_degrees": {
"type": "number",
"description": "The area of the location in square degrees",
"format": "double"
},
"bbox": {
"type": "string",
"description": "The bounding box coordinates of the location"
},
"lat": {
"type": "number",
"description": "The latitude coordinate",
"format": "double"
},
"lon": {
"type": "number",
"description": "The longitude coordinate",
"format": "double"
}
},
"required": [
"area_square_degrees",
"bbox",
"lat",
"lon"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"placeType",
"geometry"
],
"additionalProperties": false
},
"region": {
"type": "object",
"description": "Represents a geographic place with its location details",
"properties": {
"id": {
"type": "integer",
"description": "The Geocoded location ID"
},
"name": {
"type": "string",
"description": "The name of the place"
},
"placeType": {
"type": "string",
"description": "The type of place (locality, region, country, etc.)"
},
"geometry": {
"type": "object",
"description": "Geographic geometry data for a location",
"properties": {
"area_square_degrees": {
"type": "number",
"description": "The area of the location in square degrees",
"format": "double"
},
"bbox": {
"type": "string",
"description": "The bounding box coordinates of the location"
},
"lat": {
"type": "number",
"description": "The latitude coordinate",
"format": "double"
},
"lon": {
"type": "number",
"description": "The longitude coordinate",
"format": "double"
}
},
"required": [
"area_square_degrees",
"bbox",
"lat",
"lon"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"placeType",
"geometry"
],
"additionalProperties": false
},
"macrohood": {
"type": "object",
"description": "Represents a geographic place with its location details",
"properties": {
"id": {
"type": "integer",
"description": "The Geocoded location ID"
},
"name": {
"type": "string",
"description": "The name of the place"
},
"placeType": {
"type": "string",
"description": "The type of place (locality, region, country, etc.)"
},
"geometry": {
"type": "object",
"description": "Geographic geometry data for a location",
"properties": {
"area_square_degrees": {
"type": "number",
"description": "The area of the location in square degrees",
"format": "double"
},
"bbox": {
"type": "string",
"description": "The bounding box coordinates of the location"
},
"lat": {
"type": "number",
"description": "The latitude coordinate",
"format": "double"
},
"lon": {
"type": "number",
"description": "The longitude coordinate",
"format": "double"
}
},
"required": [
"area_square_degrees",
"bbox",
"lat",
"lon"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"placeType",
"geometry"
],
"additionalProperties": false
},
"neighbourhood": {
"type": "object",
"description": "Represents a geographic place with its location details",
"properties": {
"id": {
"type": "integer",
"description": "The Geocoded location ID"
},
"name": {
"type": "string",
"description": "The name of the place"
},
"placeType": {
"type": "string",
"description": "The type of place (locality, region, country, etc.)"
},
"geometry": {
"type": "object",
"description": "Geographic geometry data for a location",
"properties": {
"area_square_degrees": {
"type": "number",
"description": "The area of the location in square degrees",
"format": "double"
},
"bbox": {
"type": "string",
"description": "The bounding box coordinates of the location"
},
"lat": {
"type": "number",
"description": "The latitude coordinate",
"format": "double"
},
"lon": {
"type": "number",
"description": "The longitude coordinate",
"format": "double"
}
},
"required": [
"area_square_degrees",
"bbox",
"lat",
"lon"
],
"additionalProperties": false
}
},
"required": [
"id",
"name",
"placeType",
"geometry"
],
"additionalProperties": false
}
},
"additionalProperties": false
},
"languageList": {
"type": "array",
"description": "List of languages the person speaks",
"items": {
"type": "object",
"properties": {
"languageName": {
"type": "string",
"description": "The name of the language"
},
"proficiency": {
"type": "string",
"description": "The proficiency level of a person in a language",
"enum": [
"ELEMENTARY",
"LIMITED_WORKING",
"PROFESSIONAL_WORKING",
"FULL_PROFESSIONAL",
"NATIVE_OR_BILINGUAL"
]
}
},
"required": [
"languageName"
],
"additionalProperties": false
}
},
"emailAvailable": {
"type": "boolean",
"description": "Whether at least one email address is available for this person"
},
"personalEmailAvailable": {
"type": "boolean",
"description": "Whether at least one personal email address is available for this person"
},
"workEmailAvailable": {
"type": "boolean",
"description": "Whether at least one work email address is available for this person"
},
"companyInvestmentList": {
"type": "array",
"description": "List of company investments made by this person",
"items": {
"type": "object",
"description": "Company investment that includes the invested company information",
"properties": {
"id": {
"type": "integer",
"description": "The unique Aviato identifier of the investment"
},
"totalAmountRaised": {
"type": "number",
"description": "The total amount raised (USD) in this investment",
"format": "double"
},
"date": {
"type": "string",
"description": "The date when the investment was made",
"format": "date-time"
},
"createdBy": {
"type": "string",
"description": "Who created this investment record"
},
"personID": {
"type": "string",
"description": "The ID of the person making the investment"
},
"companyID": {
"type": "string",
"description": "The ID of the company receiving the investment"
},
"companyInvestorID": {
"type": "string",
"description": "The ID of the company making the investment"
},
"company": {
"type": "object",
"description": "This object represents a company. It includes only the most essential information to identify a company.",
"properties": {
"id": {
"type": "string",
"description": "The Aviato ID of the company"
},
"name": {
"type": "string",
"description": "The name of the company"
},
"description": {
"type": "string",
"description": "Description of the company"
},
"country": {
"type": "string",
"description": "The country of the company (Full country name)"
},
"region": {
"type": "string",
"description": "The region of the company (state/province)"
},
"locality": {
"type": "string",
"description": "The locality of the company (city/town/village)"
},
"URLs": {
"type": "object",
"description": "This object represents different urls that can be associated with any type of entity. (Does not include http prefix)",
"properties": {
"golden": {
"type": "string"
},
"contact": {
"type": "string"
},
"twitter": {
"type": "string"
},
"website": {
"type": "string"
},
"facebook": {
"type": "string"
},
"github": {
"type": "string"
},
"linkedin": {
"type": "string"
},
"pitchbook": {
"type": "string"
},
"angelList": {
"type": "string"
},
"signalNFX": {
"type": "string"
},
"crunchbase": {
"type": "string"
}
},
"additionalProperties": false
},
"industryList": {
"type": "array",
"description": "The industries the company is associated with.",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"additionalProperties": false
}
},
"required": [
"id"
],
"additionalProperties": false
}
},
"fundInvestmentList": {
"type": "array",
"description": "List of fund investments made by this person",
"items": {
"type": "object",
"description": "This object represents a fund raised by an organization. It includes the investors of the fund (which can be other organizations, or people), along with the name, amount raised, and date it was raised.",
"properties": {
"id": {
"type": "integer",
"description": "The unique Aviato identifier of the fund"
},
"name": {
"type": "string",
"description": "The name of the fund"
},
"date": {
"type": "string",
"description": "The date when the fund was raised",
"format": "date-time"
},
"amountRaised": {
"type": "number",
"description": "The total amount raised by the fund",
"format": "double"
},
"companyInvestorList": {
"type": "array",
"description": "List of companies that invested in this fund",
"items": {
"type": "object",
"description": "This object represents a company. It includes only the most essential information to identify a company.",
"properties": {
"id": {
"type": "string",
"description": "The Aviato ID of the company"
},
"name": {
"type": "string",
"description": "The name of the company"
},
"description": {
"type": "string",
"description": "Description of the company"
},
"country": {
"type": "string",
"description": "The country of the company (Full country name)"
},
"region": {
"type": "string",
"description": "The region of the company (state/province)"
},
"locality": {
"type": "string",
"description": "The locality of the company (city/town/village)"
},
"URLs": {
"type": "object",
"description": "This object represents different urls that can be associated with any type of entity. (Does not include http prefix)",
"properties": {
"golden": {
"type": "string"
},
"contact": {
"type": "string"
},
"twitter": {
"type": "string"
},
"website": {
"type": "string"
},
"facebook": {
"type": "string"
},
"github": {
"type": "string"
},
"linkedin": {
"type": "string"
},
"pitchbook": {
"type": "string"
},
"angelList": {
"type": "string"
},
"signalNFX": {
"type": "string"
},
"crunchbase": {
"type": "string"
}
},
"additionalProperties": false
},
"industryList": {
"type": "array",
"description": "The industries the company is associated with.",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"additionalProperties": false
}
},
"personInvestorList": {
"type": "array",
"description": "List of people who invested in this fund",
"items": {
"type": "object",
"description": "A Person Object, with only the most essentail information to identify the person",
"properties": {
"id": {
"type": "string",
"description": "The Aviato ID of the person"
},
"fullName": {
"type": "string",
"description": "The full name of the person"
},
"firstName": {
"type": "string",
"description": "The first name of the person"
},
"lastName": {
"type": "string",
"description": "The last name of the person"
},
"entityType": {
"type": "string",
"enum": [
"person",
"company",
"school",
"organization"
]
},
"location": {
"type": "string",
"description": "The location of the person."
},
"URLs": {
"type": "object",
"description": "This object represents different urls that can be associated with any type of entity. (Does not include http prefix)",
"properties": {
"golden": {
"type": "string"
},
"contact": {
"type": "string"
},
"twitter": {
"type": "string"
},
"website": {
"type": "string"
},
"facebook": {
"type": "string"
},
"github": {
"type": "string"
},
"linkedin": {
"type": "string"
},
"pitchbook": {
"type": "string"
},
"angelList": {
"type": "string"
},
"signalNFX": {
"type": "string"
},
"crunchbase": {
"type": "string"
}
},
"additionalProperties": false
}
},
"required": [
"id",
"fullName",
"firstName",
"lastName"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"companyInvestorList",
"personInvestorList"
],
"additionalProperties": false
}
},
"foundedCompanyList": {
"type": "array",
"description": "List of companies founded by this person",
"items": {
"type": "object",
"description": "This object represents a company. It includes only the most essential information to identify a company.",
"properties": {
"id": {
"type": "string",
"description": "The Aviato ID of the company"
},
"name": {
"type": "string",
"description": "The name of the company"
},
"description": {
"type": "string",
"description": "Description of the company"
},
"country": {
"type": "string",
"description": "The country of the company (Full country name)"
},
"region": {
"type": "string",
"description": "The region of the company (state/province)"
},
"locality": {
"type": "string",
"description": "The locality of the company (city/town/village)"
},
"URLs": {
"type": "object",
"description": "This object represents different urls that can be associated with any type of entity. (Does not include http prefix)",
"properties": {
"golden": {
"type": "string"
},
"contact": {
"type": "string"
},
"twitter": {
"type": "string"
},
"website": {
"type": "string"
},
"facebook": {
"type": "string"
},
"github": {
"type": "string"
},
"linkedin": {
"type": "string"
},
"pitchbook": {
"type": "string"
},
"angelList": {
"type": "string"
},
"signalNFX": {
"type": "string"
},
"crunchbase": {
"type": "string"
}
},
"additionalProperties": false
},
"industryList": {
"type": "array",
"description": "The industries the company is associated with.",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"fullName",
"firstName",
"lastName",
"skills",
"certifications",
"investedRoundList",
"investedIndustries",
"investorCategoryList",
"computed_highlightList"
],
"additionalProperties": false
},
"lookupSuccessful": {
"type": "boolean"
}
},
"required": [
"lookupSuccessful"
],
"additionalProperties": false
}
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute aviato_person_bulk_enrich --payload '{
"lookups": "array"
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `0.14` per pricing unit.
* Billing mode: `post_deduct`.