---
title: "List Personas"
method: GET
path: "/v1/personas"
tags: ["personas"]
---

# List Personas

`GET /v1/personas`

## Request

- Base URL: `https://api.evidenso.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.evidenso.com/v1/personas`
- Auth: HTTP bearer

Return the personas that the authenticated user can access.
Mirrors /persona/list-detailed but under the versioned REST path.
Supports pagination via limit and offset parameters.
Supports filtering by comma-separated IDs via the `ids` parameter.

## Query parameters

- `job_role` string, nullable: Filter personas by job role (individual characteristics)
- `society_id` string, nullable: Filter personas by exact society identifier
- `ids` string, nullable: Comma-separated list of persona IDs to fetch
- `limit` integer: Maximum number of personas to return
- `offset` integer: Number of personas to skip for pagination

## Response `200`

Successful Response

- PersonaListResp
  - `personas` PersonaInfo[], required
    - `id` string, required
    - `name` string, required
    - `uuid` string, nullable
    - `role` string, nullable
    - `description` string, nullable
    - `job` string, nullable
    - `age` string, nullable
    - `location` string, nullable
    - `avatar` string, nullable
    - `industry` string, nullable
    - `interests` string[], required
    - `pain_points` string[], nullable: List of pain points from decision characteristics
    - `company` CompanyInfo: Company characteristics associated with a persona
      - `company_name` string, nullable
      - `company_size` string, nullable
      - `industry` string, nullable
      - `growth_stage` string, nullable
      - `business_model` string, nullable
      - `hq_location` string, nullable
      - `markets_served` string, nullable
      - `main_clients` string, nullable
      - `main_workflows` string, nullable
      - `tech_maturity` string, nullable
      - `regulatory_environment` string, nullable
      - `ownership_type` string, nullable
      - `business_cycle` string, nullable
      - `macro_environment` string, nullable
      - `organizational_change` string, nullable
      - `ecosystem_dependencies` string, nullable
      - `region_focus` string, nullable
      - `operating_model` string, nullable
      - `preferred_tools` string, nullable
      - `key_integrations` string, nullable
    - `isFavorite` boolean, required
    - `createdAt` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/evidenso/apis/persona-rag-api.md) - [All operations](https://skmtc.dev/evidenso/apis/persona-rag-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evidenso/apis/persona-rag-api/revisions/86408c178d4f?raw)