curl https://api.avina.io/v1/people/search/$SEARCH_ID/results \
-H "Authorization: Bearer $AVINA_API_KEY"
import os
import requests
response = requests.get(
f"https://api.avina.io/v1/people/search/{search_id}/results",
headers={"Authorization": f"Bearer {os.environ['AVINA_API_KEY']}"},
)
response.raise_for_status()
print(response.json())
const response = await fetch(`https://api.avina.io/v1/people/search/${searchId}/results`, {
headers: {
Authorization: `Bearer ${process.env.AVINA_API_KEY}`,
},
});
const data = await response.json();
console.log(data);
{
"object": "list",
"data": [
{
"object": "person_search_result",
"result_id": "res_4Hn7Xc2pL9",
"name": "Jordan Avery",
"title": "Head of Revenue Operations",
"seniority": "head",
"department": "operations",
"linkedin_url": "https://www.linkedin.com/in/jordan-avery-example",
"location": { "country": "US", "state": "New York", "city": "New York" },
"email": "jordan.avery@northwindpay.example",
"email_status": "valid",
"phone": null,
"company": {
"name": "Northwind Pay",
"domain": "northwindpay.example",
"linkedin_url": "https://www.linkedin.com/company/northwind-pay-example",
"industries": ["Financial Services"],
"employee_count": { "low": 201, "high": 500 },
"headquarters": { "country": "US", "state": "New York", "city": "New York" }
},
"matched_criteria": [
{
"criterion": "person.title",
"verdict": "matched",
"evidence": {
"summary": "Current title: Head of Revenue Operations",
"sources": ["https://www.linkedin.com/in/jordan-avery-example"],
"items": []
}
},
{
"criterion": "company.headquarters.country",
"verdict": "matched",
"evidence": {
"summary": "Headquarters country: US",
"sources": [],
"items": []
}
},
{
"criterion": "company.industry",
"verdict": "matched",
"evidence": {
"summary": "Industry: Financial Services",
"sources": [],
"items": []
}
},
{
"criterion": "company.employee_count",
"verdict": "matched",
"evidence": {
"summary": "Employees: 201–500",
"sources": [],
"items": []
}
}
],
"found_at": "2026-11-12T17:11:05Z"
}
],
"has_more": false,
"next_cursor": "1",
"search_status": "completed"
}
{
"error": {
"code": "invalid_request",
"message": "after: not a valid cursor",
"request_id": "req_8f2a61c09d4e7b3a5f10c2d8",
"details": [
{ "field": "after", "message": "not a valid cursor" }
]
}
}
List people search results
Returns the people a search has found, in the order they were found.
GET
/
v1
/
people
/
search
/
{search_id}
/
results
curl https://api.avina.io/v1/people/search/$SEARCH_ID/results \
-H "Authorization: Bearer $AVINA_API_KEY"
import os
import requests
response = requests.get(
f"https://api.avina.io/v1/people/search/{search_id}/results",
headers={"Authorization": f"Bearer {os.environ['AVINA_API_KEY']}"},
)
response.raise_for_status()
print(response.json())
const response = await fetch(`https://api.avina.io/v1/people/search/${searchId}/results`, {
headers: {
Authorization: `Bearer ${process.env.AVINA_API_KEY}`,
},
});
const data = await response.json();
console.log(data);
{
"object": "list",
"data": [
{
"object": "person_search_result",
"result_id": "res_4Hn7Xc2pL9",
"name": "Jordan Avery",
"title": "Head of Revenue Operations",
"seniority": "head",
"department": "operations",
"linkedin_url": "https://www.linkedin.com/in/jordan-avery-example",
"location": { "country": "US", "state": "New York", "city": "New York" },
"email": "jordan.avery@northwindpay.example",
"email_status": "valid",
"phone": null,
"company": {
"name": "Northwind Pay",
"domain": "northwindpay.example",
"linkedin_url": "https://www.linkedin.com/company/northwind-pay-example",
"industries": ["Financial Services"],
"employee_count": { "low": 201, "high": 500 },
"headquarters": { "country": "US", "state": "New York", "city": "New York" }
},
"matched_criteria": [
{
"criterion": "person.title",
"verdict": "matched",
"evidence": {
"summary": "Current title: Head of Revenue Operations",
"sources": ["https://www.linkedin.com/in/jordan-avery-example"],
"items": []
}
},
{
"criterion": "company.headquarters.country",
"verdict": "matched",
"evidence": {
"summary": "Headquarters country: US",
"sources": [],
"items": []
}
},
{
"criterion": "company.industry",
"verdict": "matched",
"evidence": {
"summary": "Industry: Financial Services",
"sources": [],
"items": []
}
},
{
"criterion": "company.employee_count",
"verdict": "matched",
"evidence": {
"summary": "Employees: 201–500",
"sources": [],
"items": []
}
}
],
"found_at": "2026-11-12T17:11:05Z"
}
],
"has_more": false,
"next_cursor": "1",
"search_status": "completed"
}
{
"error": {
"code": "invalid_request",
"message": "after: not a valid cursor",
"request_id": "req_8f2a61c09d4e7b3a5f10c2d8",
"details": [
{ "field": "after", "message": "not a valid cursor" }
]
}
}
Available while the search is still running. Reading results is free.
Results are only ever added, never changed or removed. Store
Every error uses the same shape. See Errors.
next_cursor and pass it as after to read only the people found since your last call. next_cursor is always returned, even on an empty page.
has_more: false means there are no more stored results right now. It does not mean the search has finished: check search_status.
Path parameters
string
required
The search’s
id, returned when it was started.Query parameters
integer
default:"25"
Page size.Range: 1 to 100.
string
The
next_cursor from the previous page. Omit it on the first call.Response
200 A page of people.
string
required
Always
list.object[]
required
People, in the order they were found.
Show item properties
Show item properties
string
required
Always
person_search_result.string
required
A stable identifier for this result within the search.
string
required
The person’s full name.
string | null
required
The person’s current job title.
string | null
The seniority level of the current role.Options:
owner, c_suite, vp, head, director, manager, senior, entry.string | null
The function of the current role, such as
sales, marketing, engineering or operations.string | null
The person’s LinkedIn profile.
object | null
string | null
Work email address.
null unless enrich_emails was set and an address was found.string | null
The result of verifying
email. valid: the mailbox accepts mail. catch_all: the domain accepts every address, so the mailbox cannot be confirmed. unknown: verification was inconclusive.string | null
Phone number.
null unless enrich_phones was set and a number was found.object
required
The person’s current employer.
Show properties
Show properties
string | null
required
The company’s name.
string
required
The company’s website domain.
string | null
The company’s LinkedIn page.
string[]
LinkedIn industry names.
object | null
object[]
required
One entry per requirement of the search, with its evidence.
Show item properties
Show item properties
string
required
Which requirement this is. A filter field such as
company.industry, a relationship such as open_jobs, or criteria.<index> for a free-text criterion, where the index is its zero-based position in criteria.string
required
The outcome of the check. Results only include records where every requirement is
matched.Options: matched, not_matched, unknown.object
required
Why the verdict was reached.
Show properties
Show properties
string
required
A one-line explanation, or a quote from the source.
string[]
required
URLs that support the verdict. Empty when the evidence is a structured record with no public page.
object[]
required
Supporting records, when the requirement is about jobs, hires or technologies.
Show item properties
Show item properties
string
required
The kind of record.Options:
job, hire, technology.string
The job title, for
job and hire.string
The person’s name, for
hire.string
The product or vendor, for
technology.string
When the job was posted, for
job.string
When the person started, for
hire.string
When the technology was detected, for
technology.string
The job’s location, for
job.string
A link to the record.
string
required
When the person was added to the results.
boolean
required
Whether more stored results are available now.
false does not mean the search has finished.string
required
Pass as
after to read the results after this page. Always returned. Store it and send it back unchanged; do not parse it.string
required
The search’s status when this page was read.Options:
queued, running, completed, failed, cancelled.Errors
| Status | Code | When |
|---|---|---|
400 | invalid_request | The request is invalid, for example a malformed after cursor or a limit out of range. |
401 | invalid_api_key | The API key is missing, invalid or revoked. |
404 | not_found | No such object in this workspace. |
429 | rate_limited | Too many requests. Retry after Retry-After seconds. |
500 | internal_error | Something went wrong on our side. Retry with backoff, and with the same Idempotency-Key if you sent one. |
curl https://api.avina.io/v1/people/search/$SEARCH_ID/results \
-H "Authorization: Bearer $AVINA_API_KEY"
import os
import requests
response = requests.get(
f"https://api.avina.io/v1/people/search/{search_id}/results",
headers={"Authorization": f"Bearer {os.environ['AVINA_API_KEY']}"},
)
response.raise_for_status()
print(response.json())
const response = await fetch(`https://api.avina.io/v1/people/search/${searchId}/results`, {
headers: {
Authorization: `Bearer ${process.env.AVINA_API_KEY}`,
},
});
const data = await response.json();
console.log(data);
{
"object": "list",
"data": [
{
"object": "person_search_result",
"result_id": "res_4Hn7Xc2pL9",
"name": "Jordan Avery",
"title": "Head of Revenue Operations",
"seniority": "head",
"department": "operations",
"linkedin_url": "https://www.linkedin.com/in/jordan-avery-example",
"location": { "country": "US", "state": "New York", "city": "New York" },
"email": "jordan.avery@northwindpay.example",
"email_status": "valid",
"phone": null,
"company": {
"name": "Northwind Pay",
"domain": "northwindpay.example",
"linkedin_url": "https://www.linkedin.com/company/northwind-pay-example",
"industries": ["Financial Services"],
"employee_count": { "low": 201, "high": 500 },
"headquarters": { "country": "US", "state": "New York", "city": "New York" }
},
"matched_criteria": [
{
"criterion": "person.title",
"verdict": "matched",
"evidence": {
"summary": "Current title: Head of Revenue Operations",
"sources": ["https://www.linkedin.com/in/jordan-avery-example"],
"items": []
}
},
{
"criterion": "company.headquarters.country",
"verdict": "matched",
"evidence": {
"summary": "Headquarters country: US",
"sources": [],
"items": []
}
},
{
"criterion": "company.industry",
"verdict": "matched",
"evidence": {
"summary": "Industry: Financial Services",
"sources": [],
"items": []
}
},
{
"criterion": "company.employee_count",
"verdict": "matched",
"evidence": {
"summary": "Employees: 201–500",
"sources": [],
"items": []
}
}
],
"found_at": "2026-11-12T17:11:05Z"
}
],
"has_more": false,
"next_cursor": "1",
"search_status": "completed"
}
{
"error": {
"code": "invalid_request",
"message": "after: not a valid cursor",
"request_id": "req_8f2a61c09d4e7b3a5f10c2d8",
"details": [
{ "field": "after", "message": "not a valid cursor" }
]
}
}