---
title: "Check a Skin Analysis V2.1 task status."
method: GET
path: "/s2s/v2.1/task/skin-analysis/{task_id}"
tags: ["V2.1"]
---

# Check a Skin Analysis V2.1 task status.

`GET /s2s/v2.1/task/skin-analysis/{task_id}`

AI tasks are asynchronous. Prefer webhook-based completion handling when the feature supports webhooks. Configure your webhook endpoint, verify webhook signatures, and use the received `task_id` to query the task result after a `success` or `error` notification. See the [webhook integration guide](/develop/webhook.md) for setup and verification details.

If webhooks are not supported for the feature, or if your integration cannot use webhooks, implement polling. After starting an AI task, keep polling the task status endpoint at the given `polling_interval` until the task status is either `success` or `error`.

Do not stop polling a running task for longer than the allowed polling window. If the task is not polled in time, the task may expire; a later status check can return `InvalidTaskId` even if processing finished, and the consumed units may still be charged.

## Path parameters

- `task_id` string, required

## Response `200`

Successful check of Skin Analysis task status

- SkinAnalysisResponseV2 — RE
  - `status` integer — Response status
  - `data` object
    - `task_status` 'running' | 'success' | 'error' — Status of this task
    - `error` 'error_exceed_max_image_size' | 'exceed_max_filesize' | 'invalid_parameter' | 'error_download_image' | 'error_download_mask' | 'error_decode_image' | 'error_decode_mask' | 'error_nsfw_content_detected' | 'error_no_face' | 'error_pose' | 'error_face_parsing' | 'error_inference' | 'exceed_nsfw_retry_limits' | 'error_upload' | 'unknown_internal_error', nullable — Errors: - \`error_exceed_max_image_size\` - Input image size exceeds the maximum limit - \`exceed_max_filesize\` - Input file size exceeds the maximum limit - \`invalid_parameter\` - Invalid parameter value - \`error_download_image\` - Download source image error - \`error_download_mask\` - Download mask image error - \`error_decode_image\` - Decode source image error - \`error_decode_mask\` - Decode mask image error - \`error_nsfw_content_detected\` - NSFW content detected in source image - \`error_no_face\` - No face detected on source image - \`error_pose\` - Failed to detect pose on source image - \`error_face_parsing\` - Failed to do face segmentation on source image - \`error_inference\` - Inference pipeline error - \`exceed_nsfw_retry_limits\` - Exceed the retry limits to avoid generated NSFW image - \`error_upload\` - Upload result image error - \`unknown_internal_error\` - Others
    - `error_message` string — Detailed description of error
    - `results` union
      - SkinAnalysisResultsV2Zip
        - `url` string, required — URL to download this result. Valid for 2 hours. The returned ZIP file contains a skinanalysisResult folder of a score_info.json file with all detection result scores and images of all detection results. Only available when format is `zip`.
      - SkinAnalysisResultsV2Json
        - `output` object[], required — The analysis result returned directly in the response body as JSON format. Only available when format is `json`.
          - `type` string — The action of Skin Analysis
          - `region` string — The region of the face where the analysis is focused
          - `raw_score` number — A floating-point value ranging from 1 to 100. The raw_score refers to the score directly predicted by the AI model
          - `ui_score` integer — An integer ranging from 1 to 100. The ui_score is the adjusted score based on the raw score
          - `score` number — A floating-point value between 1 and 100 representing the general skin condition.
          - `mask_urls` string[] — The URLs of the mask images or resized images generated during analysis

## Other responses

- `400` — Invalid task ID
- `401` — Invalid or missing API key
- `500` — Task execution timeout

---

[API](https://skmtc.net/perfectcorp/apis/ai-skin-analysis.md) · [All operations](https://skmtc.net/perfectcorp/apis/ai-skin-analysis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/perfectcorp/ai-skin-analysis/versions/3b5a7dcb2864/schema)