---
title: "Check Motion Status"
method: GET
path: "/v2/photo_avatar"
tags: ["Avatar"]
---

# Check Motion Status

`GET /v2/photo_avatar`

Check the status of motion generation task by motion ID

## Query parameters

- `motion_id` string, required

## Response `200`

Success

- object
  - `code` integer, required — Business status code: * 0 - Success * 10104 - Record not found * 10105 - Invalid API key * 18020 - Insufficient credit * 18025 - No permission to call APIs * 40000 - Parameter error * 50000 - System error
  - `msg` string, required — Response message
  - `data` object
    - `motion_id` string — Motion ID
    - `avatar_id` integer — Avatar ID
    - `image_url` string, uri — Image URL
    - `name` string — Avatar name
    - `status` 'pending' | 'processing' | 'completed' | 'failed' — Task status
    - `motion_preview_url` string, uri — Motion preview URL
    - `voice_id` string — Voice ID
    - `error_msg` string, nullable — Error message (if failed)

---

[API](https://skmtc.net/jogg/apis/joggai-openapi-v2.md) · [All operations](https://skmtc.net/jogg/apis/joggai-openapi-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jogg/joggai-openapi-v2/versions/ec8807ce9c12/schema)