Skip to main content
GET
List personas

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Response

object[] | null

OK

canonical_job_titles_excludes
object[] | null
required

Canonical job titles the persona rejects, resolved to their labels

canonical_job_titles_includes
object[] | null
required

Canonical job titles the persona matches, resolved to their labels

countries
string[] | null
required

Country codes the persona is scoped to

Example:
country_excludes
string[] | null
required

Country codes the persona excludes

Example:
criteria_only
boolean
required

True when the persona exists only to drive scoring criteria. Such a persona defines no people search and is rejected by People search's persona_id.

Example:

false

id
string
required

Persona UUID

Example:

"b3c6f5e2-1234-4abc-9def-0123456789ab"

job_titles_excludes
string[] | null
required

Free-text job titles the persona rejects

Example:
job_titles_includes
string[] | null
required

Free-text job titles the persona matches

Example:
name
string
required

Persona name

Example:

"Head of Sales — France"

seniority_includes
string[] | null
required

Seniority bands the persona keeps, judged by Tamtam from the job title. Applied to fetched results, never sent to a search provider.

Example:
tier_level
integer<int64>
required

Priority tier the account assigned to this persona. Lower is more important.

Example:

1

usages
string[] | null
required

What the account uses this persona for. Effective values: 'prospecting', 'closing_deals'.

Example: