Get persona

Retrieve your workspace's ideal customer profile targeting criteria.

Get persona

GET/api/v2/persona

Returns the authenticated workspace's persona. Returns 200 with { "data": null } when no persona has been configured yet — this is a normal state for a fresh workspace, not an error.

Example request

curl "https://api.getsillage.com/api/v2/persona" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"
const response = await fetch('https://api.getsillage.com/api/v2/persona', {
  headers: {
    Authorization: `Bearer ${process.env.SILLAGE_API_KEY}`,
  },
})

const result = await response.json()
import { request } from 'node:https'

const req = request(
  new URL('https://api.getsillage.com/api/v2/persona'),
  {
    headers: {
      Authorization: `Bearer ${process.env.SILLAGE_API_KEY}`,
    },
  },
  (res) => {
    let data = ''
    res.on('data', (chunk) => {
      data += chunk
    })
    res.on('end', () => {
      console.log(JSON.parse(data))
    })
  },
)

req.end()
import os
import requests

response = requests.get(
    "https://api.getsillage.com/api/v2/persona",
    headers={"Authorization": f"Bearer {os.environ['SILLAGE_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
result = response.json()

Example response

Configured workspace:

{
  "data": {
    "id": 1234,
    "job_title": ["VP Sales", "Head of Sales"],
    "exclude_job_title": null,
    "location": ["France", "Germany"],
    "headcount": null,
    "industry": null,
    "seniority": ["vp", "director"],
    "additional_info": null
  }
}

Fresh workspace with no persona yet:

{
  "data": null
}

Response fields

FieldTypeDescription
dataobject | nullPersona object, or null if no persona has been configured.
data.idintegerPersona numeric SQL identifier. Not portable across environments.
data.job_titlestring[]Target job titles.
data.exclude_job_titlestring[]Job titles to exclude.
data.locationstring[]Target locations.
data.headcountstring[]Target headcount ranges. Valid values: 1-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, 10,001+.
data.industrystring[]Target industries.
data.senioritystring[]Target seniority levels. Valid values: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern.
data.additional_infostringAdditional free-text persona context.

On this page