> ## Documentation Index
> Fetch the complete documentation index at: https://docs.herodotus.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Task Status

> Retrieve the current processing status and details of an HDP task by its UUID

# Get Task Status

Retrieves the current status of a scheduled Data Processor task. This endpoint does not require authentication.

## Endpoint

```
GET /tasks/{task_uuid}/status
```

## Path Parameters

| Parameter  | Type   | Description                              |
| ---------- | ------ | ---------------------------------------- |
| task\_uuid | string | The unique identifier (UUID) of the task |

## Example Request

```bash theme={null}
curl -X GET https://staging.hdp.api.herodotus.cloud/tasks/01JPJ03YJT1A93D6NF56G4GVEQ/status \
  -H "Content-Type: application/json"
```

## Response

### Success Response (200 OK)

```json theme={null}
{
  "taskId": "01JPJ03YJT1A93D6NF56G4GVEQ",
  "status": "AtlanticProvingStarted",
  "errorMessage": null,
  "updatedAt": "2024-03-17T10:24:00Z"
}
```

### Not Found Response (404)

```json theme={null}
{
  "error": "Task not found",
  "taskId": "01JPJ03YJT1A93D6NF56G4GVEQ"
}
```

### Server Error Response (500)

```json theme={null}
{
  "error": "Internal Server Error"
}
```

### Response Fields

| Field        | Type           | Description                                     |
| ------------ | -------------- | ----------------------------------------------- |
| taskId       | string         | The unique identifier of the task               |
| status       | string         | Current status of the task                      |
| errorMessage | string \| null | Error message if task failed, null otherwise    |
| updatedAt    | string         | ISO 8601 timestamp of the last status update    |
| error        | string         | Error message (only present in error responses) |

### Possible Status Values

* `Received`: Task has been received and is queued
* `DryRunStarted`: Dry run validation has started
* `DryRunCompleted`: Dry run validation completed successfully
* `DryRunFailed`: Dry run validation failed
* `ChainProofsFetchStarted`: Started fetching chain storage proofs
* `ChainProofsFetchCompleted`: Chain proofs fetched successfully
* `ChainProofsFetchFailed`: Failed to fetch chain storage proofs
* `TraceGenStarted`: Trace generation has started
* `TraceGenCompleted`: Trace generation completed successfully
* `TraceGenFailed`: Trace generation failed
* `AtlanticProvingStarted`: Atlantic proving has started
* `AtlanticProvingCompleted`: Atlantic proving completed successfully
* `AtlanticProvingFailed`: Atlantic proving failed
* `TaskDecommitmentStarted`: Task decommitment has started
* `TaskDecommitmentCompleted`: Task decommitment completed successfully. This is the final status for completed workflows.
* `TaskDecommitmentFailed`: Task decommitment failed

## Notes

* No authentication is required for this endpoint
* The response includes the task ID and current status
* For completed tasks, the response includes the completion timestamp
* If the task failed, the error message will be included in the response
* The status endpoint can be polled to track task progress