List Personas

Returns a paginated list of your workspace's personas — each one a distinct ideal customer profile (business line) used for signal scoring, account prioritization, and content generation. Archived personas are excluded.

List personas

GET/api/v2/personas

Query parameters

Parameter	Type	Description
page	integer	Page number (starts at 1). Defaults to 1.
page_size	integer	Number of items per page. Defaults to 25. Maximum: 100.

Example request

curl "https://api.getsillage.com/api/v2/personas?page=1&page_size=25" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

Example response

{
  "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,
      "tag": "enterprise-emea"
    },
    {
      "id": 1235,
      "job_title": ["SDR"],
      "exclude_job_title": null,
      "location": ["United States"],
      "headcount": null,
      "industry": null,
      "seniority": null,
      "additional_info": null,
      "tag": "smb-us"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "total": 2
    }
  }
}

Response fields

Field	Type	Description
data	array	The page of personas.
data[].id	integer	ID of the persona, as returned by this endpoint. This ID is specific to your environment.
data[].job_title	string[]	Target job titles.
data[].exclude_job_title	string[]	Job titles to exclude.
data[].location	string[]	Target locations.
data[].headcount	string[]	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[].industry	string[]	Target industries.
data[].seniority	string[]	Target seniority levels. Valid values: `owner`, `founder`, `c_suite`, `partner`, `vp`, `head`, `director`, `manager`, `senior`, `entry`, `intern`.
data[].additional_info	string	Additional free-text persona context.
data[].tag	string	Short free-form label you can set to recognise this persona in your own systems. Never used for targeting, and unique across your workspace's personas.
meta.pagination.page	integer	Current page number.
meta.pagination.page_size	integer	Number of personas per page.
meta.pagination.page_count	integer	Total number of pages.
meta.pagination.total	integer	Total number of active personas in your workspace.

Errors

Status	Description
401	The API key is missing or invalid.
422	Invalid `page` or `page_size` query parameter.
429	Too many requests.
500	An unexpected server error occurred.