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

# GET /api/personas/

`GET /api/personas/`

Mixin to provide a reusable `list` method for filtering and paginating queryset results.

## Query parameters

- `age_range` 'child' | 'teen' | 'adult' | 'senior'
- `gender` 'm' | 'f' | 'nb'
- `location` 'outdoor' | 'fantasy' | 'indoor' | 'other'
- `style` 'selfie' | 'presenter' | 'other'
- `suitable_industries` integer[]

## Response `200`

- Persona[]
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `gender` 'm' | 'f' | 'nb', required — * `m` - Male * `f` - Female * `nb` - Non-Binary
  - `age_range` 'child' | 'teen' | 'adult' | 'senior' — * `child` - Child * `teen` - Teen * `adult` - Adult * `senior` - Senior
  - `location` 'outdoor' | 'fantasy' | 'indoor' | 'other' — * `outdoor` - Outdoor * `fantasy` - Fantasy * `indoor` - Indoor * `other` - Other
  - `style` 'selfie' | 'presenter' | 'other' — * `selfie` - Selfie * `presenter` - Presenter * `other` - Other
  - `creator_name` string, required
  - `video_scene` string, nullable — A word to describe the background setting. API user rely on this
  - `video` string, uri, required
  - `keywords` string, nullable — keywords (comma separated)
  - `suitable_industries` string, required
  - `preview_image_16_9` string, nullable, required
  - `preview_image_1_1` string, nullable, required
  - `preview_image_9_16` string, nullable, required
  - `preview_video_16_9` string, nullable, required
  - `preview_video_1_1` string, nullable, required
  - `preview_video_9_16` string, nullable, required
  - `landscape_preview_video` string, uri, nullable, required — Landscape preview video of the persona
  - `squared_preview_video` string, uri, nullable, required — Squared preview video of the persona
  - `portrait_preview_video` string, uri, nullable, required — Portrait preview video of the persona
  - `is_active` boolean, required — Is the creator active to use, if not, it will not be shown in the UI
  - `process_status` string, required
  - `failed_reason` string, required
  - `type` string, required

---

[API](https://skmtc.dev/creatify/apis/creatify-ai-api.md) · [All operations](https://skmtc.dev/creatify/apis/creatify-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/creatify/creatify-ai-api/revisions/7ca3bf8077ba/schema)