curl https://api.avina.io/v1/personas/$PERSONA_ID \
-H "Authorization: Bearer $AVINA_API_KEY"
import os
import requests
response = requests.get(
f"https://api.avina.io/v1/personas/{persona_id}",
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/personas/${personaId}`, {
headers: {
Authorization: `Bearer ${process.env.AVINA_API_KEY}`,
},
});
const data = await response.json();
console.log(data);
{
"object": "persona",
"id": "c92d77d7-cc85-4a62-bcec-518b1d7d6260",
"name": "Sales leaders",
"job_titles": ["VP Sales", "CRO", "Head of Sales"],
"contacts_per_company": 2,
"enrich_emails": true,
"enrich_phones": false,
"contact_countries": ["US", "CA"],
"created_at": "2026-10-05T17:02:11Z",
"updated_at": "2026-10-05T17:02:11Z"
}
{
"error": {
"code": "invalid_api_key",
"message": "The API key is invalid or revoked.",
"request_id": "req_8f2a61c09d4e7b3a5f10c2d8"
}
}
Get a persona
Returns one persona.
GET
/
v1
/
personas
/
{persona_id}
curl https://api.avina.io/v1/personas/$PERSONA_ID \
-H "Authorization: Bearer $AVINA_API_KEY"
import os
import requests
response = requests.get(
f"https://api.avina.io/v1/personas/{persona_id}",
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/personas/${personaId}`, {
headers: {
Authorization: `Bearer ${process.env.AVINA_API_KEY}`,
},
});
const data = await response.json();
console.log(data);
{
"object": "persona",
"id": "c92d77d7-cc85-4a62-bcec-518b1d7d6260",
"name": "Sales leaders",
"job_titles": ["VP Sales", "CRO", "Head of Sales"],
"contacts_per_company": 2,
"enrich_emails": true,
"enrich_phones": false,
"contact_countries": ["US", "CA"],
"created_at": "2026-10-05T17:02:11Z",
"updated_at": "2026-10-05T17:02:11Z"
}
{
"error": {
"code": "invalid_api_key",
"message": "The API key is invalid or revoked.",
"request_id": "req_8f2a61c09d4e7b3a5f10c2d8"
}
}
Path parameters
string
required
The persona’s
id.Response
200 The persona.
string
required
Always
persona.string
required
The persona’s identifier. Use it in
persona_ids.string | null
A label for the persona.
string[]
required
The job titles to look for at each company.
integer
required
How many contacts to find per company for this persona.
boolean
required
Whether to look up email addresses.
boolean
required
Whether to look up phone numbers.
string[] | null
Where the contacts are located, as ISO 3166-1 alpha-2 codes. This is the person’s location, not the company’s headquarters.
null or empty means worldwide.string
required
When the persona was created.
string
required
When the persona was last changed.
Errors
| Status | Code | When |
|---|---|---|
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/personas/$PERSONA_ID \
-H "Authorization: Bearer $AVINA_API_KEY"
import os
import requests
response = requests.get(
f"https://api.avina.io/v1/personas/{persona_id}",
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/personas/${personaId}`, {
headers: {
Authorization: `Bearer ${process.env.AVINA_API_KEY}`,
},
});
const data = await response.json();
console.log(data);
{
"object": "persona",
"id": "c92d77d7-cc85-4a62-bcec-518b1d7d6260",
"name": "Sales leaders",
"job_titles": ["VP Sales", "CRO", "Head of Sales"],
"contacts_per_company": 2,
"enrich_emails": true,
"enrich_phones": false,
"contact_countries": ["US", "CA"],
"created_at": "2026-10-05T17:02:11Z",
"updated_at": "2026-10-05T17:02:11Z"
}
{
"error": {
"code": "invalid_api_key",
"message": "The API key is invalid or revoked.",
"request_id": "req_8f2a61c09d4e7b3a5f10c2d8"
}
}