get_task_history

imerit_ango.sdk.SDK.

get_task_history(task_history_id, task_id)

Get the stage history of a task.

Parameters

• task_history_id: string, optional, default None

  • The unique identifier of the task history item.

  • Example: '0000000aa0a00a0000aaaa0a'

• task_id: string, optional, default None

  • The unique identifier of the task whose history will be retrieved. Task IDs can be obtained from the UI, and from the get_tasks function.

  • Example: '0000000aa0a00a0000aaaa0a'

Either task_history_id or task_id must be provided when calling the get_task_history function.

Returns:

• output: dict

  • A dictionary containing the result of the operation.

  • Including a status field indicating whether the request was successful and a data field containing the response payload with updated resources produced by the operation.

Example

Get the task history of a specific task.

python

import os
from dotenv import load_dotenv
from imerit_ango.sdk import SDK

load_dotenv('variables.env')
api_key = os.getenv('API_KEY')

ango_sdk = SDK(api_key)

task_id = "<YOUR TASK ID>"
sdk_response = ango_sdk.get_task_history(task_id=task_id)

curl

curl -X GET "https://imeritapi.ango.ai/v2/task/$TASK_ID/history" \
  -H "Content-Type: application/json" \
  -H "apikey: $ANGO_API_KEY"

Sample Output

{
    "status": "success",
    "data": {
        "taskHistory": [
            {
                "id": "TASK_HISTORY_ID",
                "labelTaskId": "TASK_ID",
                "answer": {
                    "tools": [...],
                    "classifications": [...],
                    "relations": [...]
                },
                "createdAt": "2026-01-01T00:00:00.000Z",
                "project": "PROJECT_ID",
                "organization": "ORGANIZATION_ID",
                "asset": {
                    "id": "ASSET_ID",
                    "data": "DATA_URL",
                    "dataset": [],
                    "overlay": [],
                    "createdAt": "2026-01-01T00:00:00.000Z",
                    "createdBy": "[e-mail]",
                    "editorType": "ango",
                    "project": "PROJECT_ID",
                    "organization": "ORGANIZATION_ID",
                    "externalId": "image.jpg",
                    "deleted": false,
                    "metadata": {
                        "width": 800,
                        "height": 600
                    },
                    "attachments": [],
                    "batches": [],
                    "isPrivate": true,
                    "storage": null,
                    "head": "DATA_URL",
                    "isPreLabeled": false,
                    "uploadStatus": "READY",
                    "_id": "ASSET_ID",
                    "labelTasks": [
                        "6a01a9c0c45ca18605830126"
                    ]
                },
                "deleted": false,
                "stage": "Label",
                "assignee": "[e-mail]",
                "consensusDetailed": [],
                "consensusIteration": 0,
                "rework": false,
                "benchmarkDetailed": [],
                "duration": 20000,
                "idleDuration": 0,
                "blurDuration": 0,
                "updatedAt": "2026-01-00T00:00:00.000Z",
                "updatedBy": "[e-mail]",
                "batches": [],
                "type": "default",
                "isSkipped": false,
                "_id": "TASK_HISTORY_ID"
            }
        ],
        "total": 1
    }
}

See also

get_task