---
title: "List GEO personas"
method: GET
path: "/v1/projects/{projectId}/geo/personas"
tags: ["GEO"]
---

# List GEO personas

`GET /v1/projects/{projectId}/geo/personas`

## Request

- Base URL: `https://api.usenotra.com`
- URL: `https://api.usenotra.com/v1/projects/{projectId}/geo/personas`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/usenotra/apis/notra-api/docs/v1/projects/:projectId/geo/personas/get.ts> (a function with typed inputs; its response is checked against the schema)

Buyer personas that hold multi-turn conversations with the answer engines, each with its profile, memories and conversation prompts. Archived personas are included with `archivedAt` set.

## Path parameters

- `projectId` string, required

## Response `200`

Personas fetched successfully

- ListGeoPersonasResponse
  - `configured` boolean, required
  - `personas` GeoPersona[], required: Active personas first in creation order, then archived ones. A project keeps at most 5 active personas.
    - `id` string, required
    - `name` string, required: Buyer archetype label, such as Budgeter.
    - `role` string, required
    - `company` string, required
    - `summary` string, required
    - `searchStyle` string, required
    - `profile` object, required
      - `goals` string[], required
      - `painPoints` string[], required
      - `currentStack` string[], required
      - `buyingTriggers` string[], required
      - `objections` string[], required
    - `conversationPrompts` string[], required: Opening prompts the persona plays against each engine. Cleared when its details change; regenerate them with `promptsOnly` before the next run.
    - `enabled` boolean, required: Whether scheduled scans play this persona.
    - `archivedAt` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `memories` object[], required
      - `id` string, required
      - `kind` 'background' | 'experience' | 'preference' | 'constraint', required
      - `content` string, required
  - `organization` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `402`: GEO plan or available AI credits required
- `403`: Forbidden
- `404`: Organization, project or resource not found
- `409`: Conflict
- `500`: Internal server error
- `503`: Authentication or billing service unavailable

## Changes

- **2026-11-05** `200d2ac38976`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usenotra/apis/notra-api/changes/v1/projects/:projectId/geo/personas/get.md)

---

[API](https://skmtc.dev/usenotra/apis/notra-api.md) - [All operations](https://skmtc.dev/usenotra/apis/notra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usenotra/apis/notra-api/revisions/607f9fffb6c7?raw)