Skip to content
Handinger
Get started
API Reference
Tasks

List task turns

tasks.list_turns(strtask_id) -> TaskTurnList
GET/api/tasks/{taskId}/turns

List the individual turns for a task in execution order.

ParametersExpand Collapse
task_id: str
ReturnsExpand Collapse
class TaskTurnList: …
items: List[Turn]
id: str
completed_at: Optional[str]
credits: int
duration_ms: int
files: List[File]

Files published by this turn.

filename: Optional[str]
media_type: str
url: str
formaturi
size: Optional[int]
minimum0
input: str
input_tokens: int
output_text: str
output_tokens: int
role: str
seq: int
started_at: str
status: str
structured_output: Optional[Dict[str, object]]

Structured JSON payload when the worker is configured with an output schema. null otherwise.

task_id: str
task_id: str

List task turns

import os
from handinger import Handinger

client = Handinger(
    api_key=os.environ.get("HANDINGER_API_KEY"),  # This is the default and can be omitted
)
task_turn_list = client.tasks.list_turns(
    "tsk_01HZY31W2SZJ8MJ2FQTR3M1K9D",
)
print(task_turn_list.items)
{
  "items": [
    {
      "id": "trn_4Hq-9Vk2pLm8Rx",
      "completedAt": "2026-05-11T09:14:48.000Z",
      "credits": 42,
      "durationMs": 25812,
      "files": [
        {
          "filename": "filename",
          "mediaType": "mediaType",
          "url": "https://example.com",
          "size": 0
        }
      ],
      "input": "What's the weather today in Barcelona?",
      "inputTokens": 1842,
      "outputText": "It's currently 21°C and sunny in Barcelona with a light breeze from the south-east.",
      "outputTokens": 312,
      "role": "assistant",
      "seq": 0,
      "startedAt": "2026-05-11T09:14:22.000Z",
      "status": "completed",
      "structuredOutput": {
        "temperatureCelsius": "bar",
        "conditions": "bar"
      },
      "taskId": "tsk_2Z-YWz3hFq6VlW"
    }
  ],
  "taskId": "tsk_2Z-YWz3hFq6VlW"
}
Returns Examples
{
  "items": [
    {
      "id": "trn_4Hq-9Vk2pLm8Rx",
      "completedAt": "2026-05-11T09:14:48.000Z",
      "credits": 42,
      "durationMs": 25812,
      "files": [
        {
          "filename": "filename",
          "mediaType": "mediaType",
          "url": "https://example.com",
          "size": 0
        }
      ],
      "input": "What's the weather today in Barcelona?",
      "inputTokens": 1842,
      "outputText": "It's currently 21°C and sunny in Barcelona with a light breeze from the south-east.",
      "outputTokens": 312,
      "role": "assistant",
      "seq": 0,
      "startedAt": "2026-05-11T09:14:22.000Z",
      "status": "completed",
      "structuredOutput": {
        "temperatureCelsius": "bar",
        "conditions": "bar"
      },
      "taskId": "tsk_2Z-YWz3hFq6VlW"
    }
  ],
  "taskId": "tsk_2Z-YWz3hFq6VlW"
}