---
title: "Get Task"
method: GET
path: "/account/tasks/{task_id}"
tags: ["account"]
---

# Get Task

`GET /account/tasks/{task_id}`

## Request

- Base URL: `https://api.beatra.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.beatra.ai/account/tasks/{task_id}`
- Auth: none declared

## Path parameters

- `task_id` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- TaskDetail
  - `task_id` string, required
  - `capability` string, required
  - `workload_type` 'model' | 'social_operation'
  - `model` string, nullable
  - `resolved_model` string, nullable
  - `social` SocialTaskIdentity
    - `platform` string, required
    - `operation_key` string, required
    - `operation_name` string, required
    - `schema_hash` string, required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
  - `phase` string, nullable
  - `created_at` string, date-time, required
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `cancel_requested_at` string, date-time, nullable
  - `progress` AppApiAccountSchemasTaskProgress
    - `percent` integer, nullable
    - `stage` string, nullable
    - `message` string, nullable
  - `error` AppApiAccountSchemasTaskError
    - `code` string, required
    - `data` object, nullable: Provider-neutral failure details after recursive supply declassification.
  - `request_parameters` object, nullable: Provider-neutral request parameters after recursive public projection.
  - `output_summary` object, nullable: Provider-neutral task output after recursive supply declassification.
  - `billing` TaskBillingSummary, required
    - `billing_mode` string, required
    - `charge_status` string, required
    - `refund_status` string, required
    - `charged_credits` string, required
    - `refunded_credits` string, required
    - `granted_credits` string, nullable
    - `grant_source` string, nullable
  - `callback` TaskCallbackSummary
    - `url` string, required
    - `status` 'pending' | 'dispatching' | 'delivered' | 'retrying' | 'failed', required
    - `attempt_count` integer, required
    - `last_status_code` integer, nullable
    - `last_error` string, nullable
    - `next_action_at` string, date-time, nullable
    - `delivered_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/beatra/apis/agent-service-api.md) · [All operations](https://skmtc.dev/beatra/apis/agent-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beatra/apis/agent-service-api/revisions/58e440556498?raw)