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

# Check a Skin Analysis + Product Recommendation task status.

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

## Request

- Base URL: `https://yce-api-01.makeupar.com`
- URL: `https://yce-api-01.makeupar.com/s2s/v2.1/task/skin-analysis-recommendation/{task_id}`
- Auth: HTTP bearer

## Path parameters

- `task_id` string, required

## Response `200`

Successful check of Skin Analysis task status

- SkinAnalysisResponseV2
  - `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. When the Advanced Skin Report or Product Recommendation is requested, the folder also contains llm_results.json. Only available when format is `zip`.
      - SkinAnalysisResultsV2Json
        - `output` object[], required: The analysis result returned directly in the response body as JSON format. When the Advanced Skin Report or Product Recommendation is requested, the output also has an item whose `type` is `llm_results`; its `mask_urls[0]` is the URL of llm_results.json. 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

## Changes

> 4 revisions in range; 1 not diffed.

- **2026-11-05** `fc95d6aa825d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/perfectcorp/apis/ai-skin-analysis/changes/s2s/v2.1/task/skin-analysis-recommendation/:task_id/get.md)

---

[API](https://skmtc.dev/perfectcorp/apis/ai-skin-analysis.md) - [All operations](https://skmtc.dev/perfectcorp/apis/ai-skin-analysis/llms.txt) - [OpenAPI document](https://skmtc.dev/perfectcorp/apis/ai-skin-analysis/revisions/fc95d6aa825d?raw)