---
title: "Get safe task state"
method: GET
path: "/api/v1/tasks/{task_id}"
tags: ["Tasks"]
---

# Get safe task state

`GET /api/v1/tasks/{task_id}`

## Request

- Base URL: `https://xcatcher.top`
- URL: `https://xcatcher.top/api/v1/tasks/{task_id}`
- Auth: HTTP bearer

## Path parameters

- `task_id` integer, required

## Response `200`

Task

- Task
  - `task_id` integer, required
  - `status` 'queued' | 'processing' | 'done' | 'failed' | 'cancelled', required
  - `status_code` integer, required
  - `task_mode` 'normal' | 'deep', nullable
  - `lines` integer, required
  - `cost_points` integer, required
  - `submit_time` string, date-time, nullable
  - `updated_time` string, date-time, nullable
  - `has_result` boolean, required
  - `result_meta` object
  - `results_url` string, nullable
  - `download_url` string, nullable
  - `error` object, nullable

## Other responses

- `404`: Not found for this account

---

[API](https://skmtc.dev/xcatcher/apis/xcatcher-agent-api.md) · [All operations](https://skmtc.dev/xcatcher/apis/xcatcher-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xcatcher/apis/xcatcher-agent-api/revisions/855ba4646e5a?raw)