---
title: "Xa Get Task"
method: GET
path: "/api/agents/tasks/{task_id}"
---

# Xa Get Task

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

## Request

- Base URL: `https://astranl.com`
- URL: `https://astranl.com/api/agents/tasks/{task_id}`
- Auth: API key in header `X-Task-Key`

## Path parameters

- `task_id` integer, required

## Response `200`

Task status for its owner. next_actor: who moves next (requester, provider, astranl, counterparty); null only in terminal states. Mapping: a linked coordination case (source_ref task:<id>) decides first, otherwise the task status. next_actor_basis names the rule that applied.

- object
  - `task_id` integer
  - `status` string, nullable
  - `payment_status` string, nullable
  - `offers_count` integer
  - `next_actor` 'requester' | 'provider' | 'astranl' | 'counterparty' | 'null', nullable
  - `next_actor_basis` string
  - `error` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/astranl/apis/astranl-public-api-positive-allowlist.md) · [All operations](https://skmtc.dev/astranl/apis/astranl-public-api-positive-allowlist/llms.txt) · [OpenAPI document](https://skmtc.dev/astranl/apis/astranl-public-api-positive-allowlist/revisions/5f86bcffe30d?raw)