---
title: "Get Character Status"
method: GET
path: "/api/v2/characters/{characterGuid}/status"
tags: ["Characters V2"]
---

# Get Character Status

`GET /api/v2/characters/{characterGuid}/status`

Returns the current processing status of a character. Poll this endpoint after generate/save operations to track progress.

## Path parameters

- `characterGuid` string, uuid, required

## Response `200`

Character status retrieved

- object
  - `characterGuid` string, uuid
  - `status` 'draft' | 'generating' | 'ready' | 'saving' | 'saved' | 'failed' — V2 character processing status: - **draft**: Initial state - **generating**: AI generation in progress - **ready**: Generation complete, ready to save - **saving**: Save in progress - **saved**: Fully saved and ready to use - **failed**: Processing failed (check errorMessage)
  - `characterId` integer — Populated when status is 'saved'
  - `errorMessage` string, nullable — Error message if processing failed
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `404` — Character not found

---

[API](https://skmtc.dev/oh/apis/ohapi-documentation.md) · [All operations](https://skmtc.dev/oh/apis/ohapi-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oh/ohapi-documentation/revisions/b623c2e9cb65/schema)