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

# List personas

`GET /personas`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/personas`
- Auth: API key in header `X-Api-Key`

Returns the workspace's personas, newest first, drafts included. `image_status` and `video_generating` say what is still being generated, so one call shows every persona in progress.

## Query parameters

- `page` number: Page number (default: 1)
- `limit` number: Items per page (default: 20, max: 100)

## Response `200`

Response for status 200

- object
  - `personas` object[], required
    - `id` string, required
    - `name` string, required
    - `status` 'draft' | 'ready', required
    - `image_status` 'generating' | 'ready' | 'failed', required
    - `video_generating` boolean, required: `true` while at least one of the persona's videos is `processing`.
    - `face_url` string, nullable, required: Signed URL of the close-up portrait, valid for one hour. `null` before the first photo is ready.
    - `created_at` string, required
  - `pagination` object, required
    - `current_page` number, required: Current page number (1-based)
    - `total_pages` number, required: Total number of pages
    - `total_count` number, required: Total number of items across all pages
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `limit` number, required: Items per page used for this response

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)