---
title: "Get Task Status"
method: GET
path: "/screenplay/tasks/{task_id}"
---

# Get Task Status

`GET /screenplay/tasks/{task_id}`

## Path parameters

- `task_id` string, required

## Response `200`

Task status retrieved successfully

- object
  - `code` integer — Response code indicating the result status
  - `msg` string — Response message
  - `data` object
    - `task_id` string — The screenplay task ID
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' — Current task status: pending, running, completed, failed, cancelled
    - `progress` object — Progress information (only present when running)
      - `total_episodes` integer — Total number of episodes to process
      - `completed_episodes` integer — Number of episodes completed so far
    - `error_code` string — Error code (only present when failed)
    - `error_message` string — Detailed error message (only present when failed)
  - `success` boolean — Indicates whether the API call was successful
  - `failed` boolean — Indicates whether the API call failed

---

[API](https://skmtc.net/memories/apis/screenplay-extraction-api.md) · [All operations](https://skmtc.net/memories/apis/screenplay-extraction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memories/screenplay-extraction-api/versions/720c8c144ddc/schema)