List Person
/unified/enrichment/person
Partial response — use the "get" endpoint for the full object.
Query Parameters
Refer Specifying query parameters in Truto APIs
Filter by the person's current job title.
3 supported
ApolloThe seniority of the person's current role. other is a level with no equivalent in this list, such as an unpaid or training role. unknown is a level the provider returned that could not be classified.
c_suitedirectorentryfounderheadinternmanagerotherownerpartnerseniorunknownvp+ 1 more
3 supported3 notes
Apolloownerfounderc_suitepartnervpheaddirectormanagerseniorentryinternFilter by the person's seniority level. Apollo supports only: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern. The unified enum's other and unknown values are never accepted by this integration and fail the request.
Filter by seniority. LeadIQ only supports vp, manager, director, c_suite and senior; any other value is rejected.
The seniority of the person's current role. Only the seniority levels this integration can filter by are accepted here; sending founder, other, or unknown fails the request.
c_suitedirectorentryheadinternmanagerownerpartnerseniorvp
Filter by the person's current employer.
3 supported
ApolloThe unique identifier of the company in the provider.
3 supported2 notes
ApolloFilter by country.
The country the person is based in.
3 supported2 notes
ApolloFilter by state or region.
The state or region the person is based in.
3 supported2 notes
ApolloFilter by city.
The city the person is based in.
Show Truto-specific parameters
The ID of the integrated account to use for the request.
62f44730-dd91-461e-bd6a-aedd9e0ad79dThe format of the response.
unifiedreturns the response with unified mappings applied.rawreturns the unprocessed, raw response from the remote API.normalizedapplies the unified mappings and returns the data in a normalized format.streamreturns the response as a stream, which is ideal for transmitting large datasets, files, or binary data. Using streaming mode helps to efficiently handle large payloads or real-time data flows without requiring the entire data to be buffered in memory.debugreturns the final unified result alongside raw remote fetch information. The response is an envelope containingresult(identical to unified mode output) anddebug(withrequestUrl,requestOptions,data,responseHeaders, and for list operations:nextCursor,isLooping,isEmptyResult,resultCount). When the upstream body exceeds 1 MiB,datais replaced by{ truto_truncated: true, truto_max_bytes, truto_excerpt }.debugisnullfor static responses or whentruto_skip_api_call=true.
Defaults to unified.
unifiedunifiedrawnormalizedstreamdebug
By default the result attribute is an array of objects. This parameter allows you to specify a field in each result objects to use as key, which transforms the result array into an object with the array items keyed by the field. This is useful for when you want to use the result as a lookup table.
idIgnores the limit query parameter.
Excludes the remote_data attribute from the response.
Array of fields to exclude from the response.
truto_exclude_fields[]=id&truto_exclude_fields[]=nameQuery parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.
remote_query[foo]=barResponse Body
Present only when truto_response_format=debug. Contains raw fetch details: requestUrl, requestOptions, data, responseHeaders, nextCursor, isLooping, isEmptyResult, resultCount. data is the parsed upstream body; when its JSON form exceeds 1 MiB it is replaced by { truto_truncated: true, truto_max_bytes, truto_excerpt }, where truto_excerpt is the leading bytes of that body. The same applies to a string requestOptions.body. null for static responses or when truto_skip_api_call=true.
The cursor to use for the next page of results. Pass this value as next_cursor in the query parameter in the next request to get the next page of results.
List of Person
The unique identifier of the person in the provider.
3 supported
ApolloThe URL of the person's profile photo.
The company the person currently works at. Its domain or LinkedIn URL can be passed to the company enrich method.
3 supported
Apollo4 properties
The company's primary website domain, without protocol or path.
The unique identifier of the company in the provider.
The URL of the company's LinkedIn page.
The name of the company.
The email addresses of the person.
1 supported
3 properties
The email address.
The provider's assessment of whether email sent to the address will be delivered. verified means the provider checked it and expects delivery. risky means delivery is uncertain, for example a catch-all domain or a likely but unconfirmed address. invalid means the provider expects the address to bounce. suppressed means the provider advises against contacting the address. unknown means the provider has not assessed it.
verifiedriskyinvalidsuppressedunknown
Whether the address is a work or a personal address.
workpersonalunknown
The first name of the person.
3 supported
ApolloThe short professional summary line shown on the person's public profile.
1 supported
The last name of the person.
2 supported
The URL of the person's LinkedIn profile.
2 supported
Where the person is based.
2 supported
3 properties
The city.
The country name.
The state or region.
The full name of the person.
3 supported
ApolloThe phone numbers of the person. Most providers return phone numbers only when requested, and charge extra for them.
2 properties
The phone number.
The type of phone number. direct is a work line that reaches the person directly. office is a company main, headquarters or branch line. personal is a personal landline or a personal number of unknown device type.
mobiledirectofficefaxpersonalotherunknown
Raw data returned from the remote API call.
The seniority of the person's current role. other is a level with no equivalent in this list, such as an unpaid or training role. unknown is a level the provider returned that could not be classified.
ownerfounderc_suitepartnervpheaddirectormanagerseniorentryinternotherunknown+ 1 more
2 supported
The person's current job title.
3 supported
ApolloThe date and time the provider last updated its data for this person.
3 supported
Apollotruto unified enrichment person \
-a '<integrated_account_id>' \
-o jsonimport Truto from '@truto/truto-ts-sdk';
const truto = new Truto({
token: '<your_api_token>',
});
const result = await truto.unifiedApi.list(
'enrichment',
'person',
{ integrated_account_id: '<integrated_account_id>' }
);
console.log(result);import asyncio
from truto_python_sdk import TrutoApi
truto_api = TrutoApi(token="<your_api_token>")
async def main():
async for item in truto_api.unified_api.list(
"enrichment",
"person",
{"integrated_account_id": "<integrated_account_id>"}
):
print(item)
asyncio.run(main())curl -X GET 'https://api.truto.one/unified/enrichment/person?integrated_account_id=<integrated_account_id>' \
-H 'Authorization: Bearer <your_api_token>' \
-H 'Content-Type: application/json'const integratedAccountId = '<integrated_account_id>';
const response = await fetch(`https://api.truto.one/unified/enrichment/person?integrated_account_id=${integratedAccountId}`, {
method: 'GET',
headers: {
'Authorization': 'Bearer <your_api_token>',
'Content-Type': 'application/json',
},
});
const data = await response.json();
console.log(data);import requests
url = "https://api.truto.one/unified/enrichment/person"
headers = {
"Authorization": "Bearer <your_api_token>",
"Content-Type": "application/json",
}
params = {
"integrated_account_id": "<integrated_account_id>"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())