---
title: "List Characters"
method: GET
path: "/api/characters/"
---

# List Characters

`GET /api/characters/`

## Query parameters

- `search` string, nullable
- `limit` integer, nullable
- `offset` integer

## Response `200`

Successful Response

- ListCharactersResponse
  - `success` boolean
  - `characters` CharacterResponse[], required
    - `id` string, required
    - `userId` string, nullable
    - `orgId` string, nullable
    - `name` string, nullable
    - `personality` string, nullable
    - `physicalAppearance` string, nullable
    - `assetId` string, nullable
    - `assetImageUrl` string, nullable
    - `voiceId` string, nullable
    - `voiceName` string, nullable
    - `voicePreviewUrl` string, nullable
    - `keywords` unknown[], nullable
      - unknown
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/latted/apis/motion-graphics-designer-api.md) · [All operations](https://skmtc.dev/latted/apis/motion-graphics-designer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/latted/motion-graphics-designer-api/revisions/36d149b525df/schema)