---
search:
  tags:
    - Tasks
    - GET
seo:
  description: >-
    Returns the status of asynchronous work and references to what it produced.
    Every… Reference for the GET /tasks/{task_id} endpoint in the Zaraftis
    Public API.
sidebar:
  label: Get a task
  badge: GET
title: Get a task
type: openapi-operation
---
Returns the status of asynchronous work and references to what it produced. Every accepted scan, check, site audit, scan report, export, and connection sync returns a task_id and task_url that point here. Poll until the task reaches a terminal status.

`GET /tasks/{task_id}`

**Responses**

- `200` — Task status (the status values include partial)
- `404` — not\_found: unknown id, or an id this key cannot see

Response example, 200:

```json
{
  "success": true,
  "data": {
    "task_id": "736fde4d-9029-4915-8189-01353d6982cb",
    "operation": "scan",
    "status": "queued",
    "progress": {
      "requested": 0,
      "completed": 0,
      "failed": 0
    },
    "error": {
      "code": "string",
      "message": "string"
    },
    "timestamps": {
      "created_at": "string",
      "started_at": "string",
      "completed_at": "string"
    },
    "scan_id": "9a59f0f5-5572-476d-a7fc-c960ef43a5af",
    "scan_url": "string",
    "site_audit_id": "f1a556fb-6cd6-4489-93d7-27a576f86eea",
    "site_audit_url": "string",
    "report_id": "5ed7905a-4735-4cf7-b1ab-521e066fb971",
    "report_url": "string",
    "export_id": "a9a55f8d-48b1-4a5b-a88e-c41b0cd75102",
    "export_url": "string",
    "integration_snapshot_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "integration_snapshot_urls": [
      "string"
    ]
  },
  "request_id": "string"
}
```