---
title: "Used to check status of an individual task by taskId. Does not contain task payload."
method: GET
path: "/v1/tasks/{taskId}"
tags: ["Notification history"]
---

# Used to check status of an individual task by taskId. Does not contain task payload.

`GET /v1/tasks/{taskId}`

## Path parameters

- `taskId` string, required — TaskId of the task to be returned.

## Response `200`

Successful Response

- TasksResponse
  - `taskStatus` Task[], required
    - `taskId` string — Task id identifies the task and is used to correlate task response to the correct operation in P2P.
    - `taskStatus` string — Status of the task (=notification). Available values: 'New', 'Completed', 'Failed'.
    - `taskType` string — Task type specifies type of document. It also determines the API endpoint from which the document needs to be fetched.
    - `taskSubType` string — Specifies status of the document when notification was sent.
    - `documentId` string — Identifies the document being processed. Same identifier is used in API from which document needs to be fetched.
    - `expirationTime` string — Timestamp after which the notification expires. Reseved for future use. Responses are no longer accepted for expired tasks.
    - `externalProcessingTime` string — Reserved for future use.
    - `isSimulatedTask` boolean — Reserved for future use. Indicates if task is a simulated task (created using 'simulate' API).
    - `lastUpdated` string — Timestamp when task has been last updated. Value is set automatically by API.
    - `taskHistory` TaskHistory[] — Shows information aboout task status changes.
      - `action` string — Action performed on the task.
      - `timeStamp` string — Timestamp when action occurred.
      - `messages` string[] — Additional information regarding task status change, such as error messages.

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/basware/apis/basware-push-notification-apis.md) · [All operations](https://skmtc.dev/basware/apis/basware-push-notification-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/basware/basware-push-notification-apis/revisions/8fa84fde6e87/schema)