---
title: "Returns task status by search criteria. Does not contain task payload."
method: GET
path: "/v1/tasks"
tags: ["Notification history"]
---

# Returns task status by search criteria. Does not contain task payload.

`GET /v1/tasks`

## Query parameters

- `taskType` string — Task type (InvoiceGenericTask, InvoiceCalcTax, etc)
- `taskStatus` string — Status of the task. Available values: 'New', 'Completed', 'Failed'.
- `documentId` string — Returns all tasks for a specific document (for example all tasks related to one AccountingDocument).
- `lastUpdated` string — Date Filter. Returns tasks which have been updated after specified datetime.

## Headers

- `x-amz-meta-continuationtoken` string — Used to get next page of results when item count indicated by 'pageSize' is exceeded. A token is returned in header (not body) parameter 'X-amz-meta-continuationToken' of the response whenever there are more records to fetch. Post the received value here in a new GET request to receive the next page of results.

## 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)