---
title: "Check the status of a AI Aging Generator task."
method: GET
path: "/s2s/v2.0/task/aging/{task_id}"
tags: ["V1.0"]
---

# Check the status of a AI Aging Generator task.

`GET /s2s/v2.0/task/aging/{task_id}`

## Path parameters

- `task_id` string, required

## Response `200`

Successful check of the task status

- AgingResponseV2
  - `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` object
      - `output` object[]
        - `url` string — URL to download this result. Valid for 2 hours
        - `res_age` integer — Age of the result that the AI engine attempts to generate. Please note that the 'res_age' of the uploaded file may not correspond to the 'age' in the results.
      - `age` integer — Estimation of the age of the uploaded file by AI engine. Please be aware that the 'res_age' of the uploaded file, as found in the 'output' section, may not align with this 'age' value.
      - `agd_idx` integer — Index of the uploaded file in the 'output'. Index is starting from 0. The first file has index 0, the second file has index 1, and so on.
      - `age_min` integer — Minimum age among files in 'output'
      - `age_max` integer — Maximum age among files in 'output'
      - `num_of_photos` integer — Number of photos in 'output'

## Other responses

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

---

[API](https://skmtc.dev/perfectcorp/apis/ai-aging-simulation.md) · [All operations](https://skmtc.dev/perfectcorp/apis/ai-aging-simulation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/perfectcorp/ai-aging-simulation/revisions/f3b74f406079/schema)