---
title: "Check the status of a task submitted to the API."
method: POST
path: "/api/v2/status"
tags: ["API"]
---

# Check the status of a task submitted to the API.

`POST /api/v2/status`

## Request body

- ApiStatusRequestDto
  - `task_uuid` string, required

## Response `201`

- ApiStatusResponseDto
  - `error` 'OK' | 'INVALID_REQUEST' | 'USER_NOT_FOUND' | 'GROUP_NOT_FOUND' | 'PERMISSION_DENIED' | 'INSUFFICIENT_BALANCE' | 'NO_SUCH_TASK' | 'TASK_INCOMPLETE' | 'SUBSCRIPTION_REQUIRED' | 'INTERNAL_SERVER_ERROR'
  - `status` 'Created' | 'Waiting' | 'Canceled' | 'Generating' | 'Done' | 'Failed'

---

[API](https://skmtc.net/deemos/apis/hyperhuman-rest-api-documentation.md) · [All operations](https://skmtc.net/deemos/apis/hyperhuman-rest-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deemos/hyperhuman-rest-api-documentation/revisions/7fcc212485fb/schema)