---
title: "Get Character"
method: GET
path: "/v1/characters/{character_id}"
tags: ["characters"]
---

# Get Character

`GET /v1/characters/{character_id}`

## Request

- Base URL: `https://api.myarchivist.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myarchivist.ai/v1/characters/{character_id}`
- Auth: HTTP bearer

Get a specific character by ID.

## Path parameters

- `character_id` string, required

## Query parameters

- `with_links` boolean: Return description with [[wikilinks]] intact

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- union
  - CharacterRead: Schema for reading character data
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, nullable
    - `id` string, required
    - `character_name` string, required
    - `character_alias` string, nullable
    - `character_aliases` string[]
    - `player_name` string, nullable
    - `player_handle` string, nullable
    - `description` string, nullable
    - `backstory` string, nullable
    - `type` string
    - `image` string, nullable
    - `campaign_id` string, required
    - `player` CharacterPlayer
      - `id` string, required
      - `name` string, nullable
      - `handle` string, nullable
      - `roles` string[]
      - `created_at` string, date-time, required
      - `campaign_id` string, required
    - `tcg_image` string, nullable
    - `merge` boolean, required
  - CharacterReadProduct
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, nullable
    - `id` string, required
    - `character_name` string, required
    - `character_alias` string, nullable
    - `character_aliases` string[]
    - `player_name` string, nullable
    - `player_handle` string, nullable
    - `description` string, nullable
    - `backstory` string, nullable
    - `type` string
    - `image` string, nullable
    - `campaign_id` string, required
    - `player` CharacterPlayer
      - `id` string, required
      - `name` string, nullable
      - `handle` string, nullable
      - `roles` string[]
      - `created_at` string, date-time, required
      - `campaign_id` string, required
    - `tcg_image` string, nullable
    - `merge` boolean, required
    - `approved` boolean
    - `pending` boolean
    - `tag_count` integer
    - `properties_updated_at` string, date-time, nullable
    - `speaker_user` CharacterUserSummary
      - `id` string, required
      - `name` string, nullable
      - `given_name` string, nullable
      - `family_name` string, nullable
      - `discord_username` string, nullable
      - `picture` string, nullable
  - CharacterReadAgent: Character detail schema for third-party AI assistants: no player account linkage.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, nullable
    - `id` string, required
    - `character_name` string, required
    - `character_alias` string, nullable
    - `character_aliases` string[]
    - `description` string, nullable
    - `backstory` string, nullable
    - `type` string, required
    - `image` string, nullable
    - `tcg_image` string, nullable
    - `campaign_id` string, required
    - `merge` boolean

## Other responses

- `422`: Validation Error

---

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