> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/static-spec-test/platform/tasks.md).

# Tasks

## Returns task statuses by Id.

> Returns task statuses by Id.

```json
{"openapi":"3.0.0","info":{"title":"Guardian","version":"0.0.1"},"tags":[{"name":"tasks"}],"servers":[{"url":"/api/v1","description":"version 1.0"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"TaskStatusDTO":{"type":"object","properties":{"action":{"type":"string","description":"Task type"},"userId":{"type":"string","description":"User Id"},"expectation":{"type":"number","description":"Expected count of task phases"},"taskId":{"type":"string","description":"Task Id"},"date":{"type":"string","description":"Date"},"statuses":{"type":"array","items":{"$ref":"#/components/schemas/StatusDTO"}},"result":{"type":"object","additionalProperties":true},"error":{"type":"object","additionalProperties":true}},"required":["action","userId","expectation","taskId","date","statuses","result","error"]},"StatusDTO":{"type":"object","properties":{"message":{"type":"string","description":"Text"},"type":{"type":"string","description":"Type","enum":["Processing","Completed","Info"]}},"required":["message","type"]},"UnauthorizedErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]},"ForbiddenErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]},"InternalServerErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/tasks/{taskId}":{"get":{"description":"Returns task statuses by Id.","operationId":"TaskApi_getTask","parameters":[{"name":"taskId","required":true,"in":"path","description":"Task Id","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskStatusDTO"}}}},"401":{"description":"Unauthorized request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedErrorDTO"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenErrorDTO"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDTO"}}}}},"summary":"Returns task statuses by Id.","tags":["tasks"]}}}}
```

## Returns task status of user onboarding by Id without authentication.

> Returns task status of user onboarding by Id. No Bearer token required.

```json
{"openapi":"3.0.0","info":{"title":"Guardian","version":"0.0.1"},"tags":[{"name":"tasks"}],"servers":[{"url":"/api/v1","description":"version 1.0"}],"paths":{"/tasks/onboard/{taskId}":{"get":{"description":"Returns task status of user onboarding by Id. No Bearer token required.","operationId":"TaskApi_getTaskStatus","parameters":[{"name":"taskId","required":true,"in":"path","description":"Task Id returned by the initiating endpoint","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskStatusDTO"}}}},"401":{"description":"Task exists but is not an onboarding task.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDTO"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDTO"}}}}},"summary":"Returns task status of user onboarding by Id without authentication.","tags":["tasks"]}}},"components":{"schemas":{"TaskStatusDTO":{"type":"object","properties":{"action":{"type":"string","description":"Task type"},"userId":{"type":"string","description":"User Id"},"expectation":{"type":"number","description":"Expected count of task phases"},"taskId":{"type":"string","description":"Task Id"},"date":{"type":"string","description":"Date"},"statuses":{"type":"array","items":{"$ref":"#/components/schemas/StatusDTO"}},"result":{"type":"object","additionalProperties":true},"error":{"type":"object","additionalProperties":true}},"required":["action","userId","expectation","taskId","date","statuses","result","error"]},"StatusDTO":{"type":"object","properties":{"message":{"type":"string","description":"Text"},"type":{"type":"string","description":"Type","enum":["Processing","Completed","Info"]}},"required":["message","type"]},"InternalServerErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]}}}}
```