---
search:
  tags:
    - Personas
    - GET
seo:
  description: >-
    Lists a Brand's Personas, newest first, as slug + name + description +…
    Reference for the GET /context/brands/{slug}/personas endpoint in the
    AdCrunch API.
sidebar:
  label: List a Brand's Personas
  badge: GET
title: List a Brand's Personas
type: openapi-operation
---
Lists a Brand's Personas, newest first, as slug + name + description + age range, with whether the body is authored. The body itself is never returned here — fetch a single Persona for it. Soft-deleted Personas are excluded.

One page at a time: `limit` rows at most, 100 by default. When the answer holds `nextCursor`, more rows exist: send it back as `cursor` to get the next page.

`GET /context/brands/{slug}/personas`

**Responses**

- `200` — One page of this Brand's Personas, newest first, with whether their body carries prose. The prose itself is never returned here. There is deliberately no organization-wide Persona listing — a Persona is addressed through its Brand. This page is the last one, so it carries no \`nextCursor\`.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed. Or AdCrunch cannot use the \`cursor\`: it cannot read it, or the cursor belongs to a different query. Then \`error\` is \`invalid\_cursor\`. Send the \`nextCursor\` of the previous page with no change, or omit \`cursor\` to get the first page.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`brand:read\`. \`error\` is \`forbidden\`.
- `404` — No Brand with that slug. \`error\` is \`not\_found\`.

Response example, 200:

```json
{
  "data": [
    {
      "ageMax": null,
      "ageMin": 18,
      "description": "Runners who have never bought direct, and who buy the shoe a shop puts in front of them.",
      "hasBody": false,
      "id": "psn_5b1e09",
      "name": "First pair",
      "slug": "first-pair"
    },
    {
      "ageMax": 45,
      "ageMin": 28,
      "description": "Runners who already own a pair, and who buy the next one without looking at another brand.",
      "hasBody": true,
      "id": "psn_8c4a20",
      "name": "Loyalists",
      "slug": "loyalists"
    }
  ]
}
```
