---
title: "Get Digital Twin Status"
method: GET
path: "/api/v1/digital-twins/status/{digitalTwinId}"
tags: ["Digital Twins"]
---

# Get Digital Twin Status

`GET /api/v1/digital-twins/status/{digitalTwinId}`

Returns the current processing status of a digital twin. Poll this endpoint after create/update operations to track progress. When status is 'active', the characterId field is populated and can be used for subsequent update calls.

## Path parameters

- `digitalTwinId` string, uuid, required

## Response `200`

Digital twin status retrieved

- object
  - `digitalTwinId` string, uuid
  - `status` 'pending' | 'active' | 'draft' | 'inactive' — Digital twin processing status: - **pending**: Creation/update in progress - **active**: Digital twin is ready and live - **draft**: Initial state before processing - **inactive**: Deactivated
  - `characterId` integer — Populated when status is 'active' - use this for update calls
  - `errorMessage` string, nullable — Error message if processing failed
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `404` — Digital twin 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)