---
title: "List active or archived reusable characters."
method: GET
path: "/api/v1/characters"
tags: ["Characters"]
---

# List active or archived reusable characters.

`GET /api/v1/characters`

## Request

- Base URL: `https://coloringbookify.com`
- URL: `https://coloringbookify.com/api/v1/characters`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `after` string
- `archived` boolean

## Response `200`

A page of characters

- CharacterListEnvelope
  - `data` Character[]
    - `id` string
    - `name` string
    - `handle` string
    - `description` string
    - `visual_description` string, nullable
    - `status` string
    - `archived` boolean
    - `public_preview` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `links` Links
  - `meta` object
    - `limit` integer
    - `next_cursor` string, nullable
    - `has_more` boolean

## Other responses

- `400`: Invalid request or idempotency key
- `401`: Bearer API key missing or invalid
- `403`: Active Business plan required

---

[API](https://skmtc.dev/coloringbookify/apis/coloringbookify-api.md) · [All operations](https://skmtc.dev/coloringbookify/apis/coloringbookify-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coloringbookify/apis/coloringbookify-api/revisions/3a2b72f610bd?raw)