Skip to main content
GET
/
personas
curl https://app.mavera.io/api/v1/personas \
  -H "Authorization: Bearer mvra_live_your_key_here"
{
  "object": "list",
  "data": [
    {
      "id": "clx1abc2d0001abcdef123456",
      "object": "persona",
      "name": "Gen Z Consumer",
      "category": "Generational",
      "description": "Digital-native consumer aged 18-25 with strong social media influence.",
      "is_custom": false,
      "is_expert": false,
      "created_at": 1706140800
    },
    {
      "id": "clx2xyz9e0002abcdef789012",
      "object": "persona",
      "name": "SaaS CMO",
      "category": "IndustrySpecific",
      "description": "Chief Marketing Officer at a B2B SaaS company with $10M+ ARR.",
      "is_custom": true,
      "is_expert": true,
      "created_at": 1706227200
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Query Parameters

​
is_custom
boolean

Filter by custom personas only

​
category
string

Filter by category

​
search
string

Search by name or description

​
limit
integer
default:50

Maximum number of results (default 50, max 100)

Required range: 1 <= x <= 100
​
cursor
string

Cursor for pagination

Response

A list of personas accessible to the authenticated user.

​
object
enum<string>

The object type, always list.

Available options:
list
Example:

"list"

​
data
object[]

The list of personas.

​
has_more
boolean

Whether there are more results available.

​
next_cursor
string | null

Cursor to use for fetching the next page.