---
title: Get Task list
slug: get-task-list
docTags: 
createdAt: 2026-10-08T08:29:29.588Z
---

{
  "id": "QA_usPHT5dPY-52M7kwHX",
  "type": "api-oas-v2",
  "data": {
    "method": "GET",
    "url": "https://dev1.frontu.com//client/api/v2/tasks",
    "servers": [
      {
        "url": "https://dev1.frontu.com//client/api/v2/tasks"
      }
    ],
    "name": "Get Task list",
    "description": "<p>This endpoint allows to return task list</p>\n<p>In this case you can get 11 different task statuses.</p>\n<p>Task status inactive - 100</p>\n<p>Task status synced - 101</p>\n<p>Task status unassigned - 102</p>\n<p>Task status reopened - 110</p>\n<p>Task status in progress - 200</p>\n<p>Task status stopped - 300</p>\n<p>Task status done - 400</p>\n<p>Task status done with note - 401</p>\n<p>Task status approved - 402</p>\n<p>Task status unsigned - 500</p>\n<p>Task status aborted - 600</p>\n<p>Task status template - 900</p>",
    "contentType": "application/json",
    "request": {
      "pathParameters": [],
      "headerParameters": [
        {
          "name": "accept",
          "type": "string",
          "kind": "optional",
          "description": "Generated from available response content types",
          "enum": [
            "application/json",
            "Example",
            "Example with custom values"
          ],
          "default": "application/json"
        }
      ],
      "queryParameters": [
        {
          "kind": "optional",
          "name": "version",
          "type": "integer",
          "description": "<p>Filter data by given timestamp ></p>",
          "default": 0,
          "pattern": "\\d+"
        },
        {
          "kind": "optional",
          "name": "versionTo",
          "type": "integer",
          "description": "<p>Filter data by given timestamp &#x3C;</p>",
          "default": 0,
          "pattern": "\\d+"
        },
        {
          "kind": "optional",
          "name": "page",
          "type": "integer",
          "description": "Page number.",
          "default": 1,
          "pattern": "\\d+"
        },
        {
          "kind": "optional",
          "name": "items",
          "type": "integer",
          "description": "<p>Items per page 100/200/300.</p>",
          "default": 100,
          "pattern": "(100|200|300)"
        },
        {
          "kind": "optional",
          "name": "guid",
          "type": "string",
          "description": "GUID format entity identifier generated by Frontu."
        },
        {
          "kind": "optional",
          "name": "systemId",
          "type": "string",
          "description": "Entity identifier from external system."
        },
        {
          "kind": "optional",
          "name": "code",
          "type": "string",
          "description": "Task code identifier."
        },
        {
          "kind": "optional",
          "name": "billStatus",
          "type": "string",
          "description": "Bill status."
        },
        {
          "kind": "optional",
          "name": "status",
          "type": "string",
          "description": "<p>Task status, if it is finished or not.</p>"
        },
        {
          "kind": "optional",
          "name": "taskType",
          "type": "string",
          "description": "<p>Tastype systemId / guid.</p>"
        },
        {
          "kind": "optional",
          "name": "client",
          "type": "string",
          "description": "<p>Client systemId / guid.</p>"
        },
        {
          "kind": "optional",
          "name": "workspace",
          "type": "string",
          "description": "<p>Workspace systemId / guid.</p>"
        },
        {
          "kind": "optional",
          "name": "office",
          "type": "string",
          "description": "<p>Office systemId / guid.</p>"
        },
        {
          "kind": "optional",
          "name": "tag",
          "type": "string",
          "description": "Tag."
        },
        {
          "kind": "optional",
          "name": "receivedByExternalSystem",
          "type": "string",
          "description": "<p>Task status, if it is received by external system.</p>"
        },
        {
          "kind": "optional",
          "name": "isChild",
          "type": "boolean",
          "description": "<p>true returns only tasks that are children of another task (parentId set), false only tasks without a parent. Also accepts 1/0. Omitted, empty or unrecognised values leave the list unfiltered.</p>"
        },
        {
          "kind": "optional",
          "name": "hasChildren",
          "type": "boolean",
          "description": "<p>true returns only tasks that have at least one child task, false only tasks with no children. Also accepts 1/0. Omitted, empty or unrecognised values leave the list unfiltered.</p>"
        },
        {
          "kind": "optional",
          "name": "pastDue",
          "type": "boolean",
          "description": "<p>1/true returns only past-due tasks, 0/false only tasks that are not past due. Exact match on the task's pastDue flag. Any other value (including an empty one) returns 400.</p>"
        }
      ],
      "bodyDataParameters": [],
      "formDataParameters": [],
      "oAuthParameters": [
        {
          "id": "Bearer",
          "name": "Authorization",
          "kind": "optional",
          "type": "apiKey",
          "description": "<p>Value: Bearer {access_token}</p>",
          "in": "header"
        }
      ],
      "cookieParameters": []
    },
    "responses": [
      {
        "statusCode": "200",
        "description": "Returned when successful",
        "jsonExample": "",
        "isExpanded": true,
        "schema": [
          {
            "kind": "optional",
            "type": "object",
            "description": "",
            "schema": [
              {
                "name": "next_page",
                "kind": "optional",
                "type": "string",
                "description": "",
                "minLength": 1
              },
              {
                "name": "items",
                "kind": "optional",
                "type": "array",
                "description": "",
                "example": "",
                "itemType": "object",
                "customType": "object[]",
                "schema": [
                  {
                    "name": "systemId",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "code",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "title",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "clientName",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "clientEmail",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "rating",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "agreement",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "signatureType",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "signatureFile",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "description",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "abortMessage",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "clientNote",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "clientNoteReply",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "distance",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "workPrice",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "workPriceWithVat",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "routePrice",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "routePriceWithVat",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "materialPrice",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "materialPriceWithVat",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "finalPrice",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "finalPriceWithVat",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "vat",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "currency",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "status",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "stopStatusMessage",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "plannedTime",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "plannedEndTime",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "fixedPlannedTime",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "fetched",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "time",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "ended",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "pastDue",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "duration",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "durationFull",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "billDate",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "billStatus",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "reassigned",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "filesExists",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "user",
                    "kind": "optional",
                    "type": "object",
                    "description": "",
                    "example": "",
                    "schema": [
                      {
                        "name": "title",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "guid",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "systemId",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      }
                    ]
                  },
                  {
                    "name": "formerUser",
                    "kind": "optional",
                    "type": "object",
                    "description": "",
                    "example": "",
                    "schema": [
                      {
                        "name": "title",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "guid",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "systemId",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      }
                    ]
                  },
                  {
                    "name": "assignor",
                    "kind": "optional",
                    "type": "object",
                    "description": "",
                    "example": "",
                    "schema": [
                      {
                        "name": "title",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "guid",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "systemId",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      }
                    ]
                  },
                  {
                    "name": "taskType",
                    "kind": "optional",
                    "type": "object",
                    "description": "",
                    "example": "",
                    "schema": [
                      {
                        "name": "title",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "guid",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "systemId",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      }
                    ]
                  },
                  {
                    "name": "workspace",
                    "kind": "optional",
                    "type": "object",
                    "description": "",
                    "example": "",
                    "schema": [
                      {
                        "name": "title",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "serialNumber",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "guid",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "systemId",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      }
                    ]
                  },
                  {
                    "name": "client",
                    "kind": "optional",
                    "type": "object",
                    "description": "",
                    "example": "",
                    "schema": [
                      {
                        "name": "title",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "companyCode",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "guid",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "systemId",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      }
                    ]
                  },
                  {
                    "name": "createdBy",
                    "kind": "optional",
                    "type": "object",
                    "description": "",
                    "example": "",
                    "schema": [
                      {
                        "name": "title",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "guid",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "systemId",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      }
                    ]
                  },
                  {
                    "name": "taskRequest",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "requireObjectCode",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "requireSignatureCode",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "taskTypePriority",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "guid",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "created",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "updated",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "version",
                    "kind": "optional",
                    "type": "number",
                    "description": ""
                  },
                  {
                    "name": "deleted",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "customValues",
                    "kind": "optional",
                    "type": "array",
                    "description": "",
                    "example": "",
                    "itemType": "object",
                    "customType": "object[]",
                    "schema": [
                      {
                        "name": "guid",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "value",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      }
                    ]
                  },
                  {
                    "name": "literalStatus",
                    "kind": "optional",
                    "type": "string",
                    "description": "",
                    "minLength": 1
                  },
                  {
                    "name": "sla",
                    "kind": "optional",
                    "type": "object",
                    "nullable": true,
                    "description": "<p>SLA assigned to the task, or null when none is assigned. duration is in MINUTES - the admin UI displays it as hours (duration / 60).</p>",
                    "example": "",
                    "schema": [
                      {
                        "name": "guid",
                        "kind": "optional",
                        "type": "string",
                        "description": ""
                      },
                      {
                        "name": "systemId",
                        "kind": "optional",
                        "type": "string",
                        "nullable": true,
                        "description": ""
                      },
                      {
                        "name": "title",
                        "kind": "optional",
                        "type": "string",
                        "nullable": true,
                        "description": ""
                      },
                      {
                        "name": "duration",
                        "kind": "optional",
                        "type": "integer",
                        "description": "SLA duration in minutes."
                      }
                    ]
                  },
                  {
                    "name": "receivedByExternalSystem",
                    "kind": "optional",
                    "type": "boolean",
                    "description": ""
                  },
                  {
                    "name": "helpers",
                    "kind": "optional",
                    "type": "array",
                    "description": "",
                    "example": "",
                    "itemType": "object",
                    "customType": "object[]",
                    "schema": [
                      {
                        "name": "title",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "guid",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      },
                      {
                        "name": "systemId",
                        "kind": "optional",
                        "type": "string",
                        "description": "",
                        "minLength": 1
                      }
                    ]
                  },
                  {
                    "name": "tags",
                    "kind": "optional",
                    "type": "array",
                    "description": "",
                    "example": "",
                    "itemType": "object",
                    "customType": "object[]",
                    "itemExample": "",
                    "itemDefault": ""
                  }
                ]
              }
            ],
            "isExpanded": true
          }
        ]
      },
      {
        "statusCode": "400",
        "description": "<p>Invalid filter value (pastDue)</p>",
        "jsonExample": "",
        "isExpanded": true
      }
    ],
    "hasXCodeSamples": false,
    "examples": {
      "languages": [
        {
          "id": "M2TCb9W0lglhm0k8-M0hr",
          "language": "curl",
          "label": "cURL",
          "code": "curl --request GET \\\n     --url 'https://dev1.frontu.com//client/api/v2/tasks?version=integer&versionTo=integer&page=1&items=100' \\\n     --header 'accept: application/json'"
        },
        {
          "id": "BS_S6VCqNANCh8IBgz81z",
          "language": "javascript",
          "label": "javascript",
          "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar requestOptions = {\n   method: 'GET',\n   headers: myHeaders,\n   redirect: 'follow'\n};\n\nfetch(\"https://dev1.frontu.com//client/api/v2/tasks?version=integer&versionTo=integer&page=1&items=100\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));"
        },
        {
          "id": "fVejs2TlNrEQIMHdA58Sc",
          "language": "ruby",
          "label": "Ruby",
          "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://dev1.frontu.com//client/api/v2/tasks?version=integer&versionTo=integer&page=1&items=100\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\n\nresponse = https.request(request)\nputs response.read_body\n"
        },
        {
          "id": "gJIu-_TUsu4HTkjmWY-eR",
          "language": "python",
          "label": "Python",
          "code": "import requests\nimport json\n\nurl = \"https://dev1.frontu.com//client/api/v2/tasks?version=integer&versionTo=integer&page=1&items=100\"\n\npayload = {}\nheaders = {\n   'accept': 'application/json',\n   'content-type': 'application/json'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
        }
      ],
      "selectedLanguageId": "M2TCb9W0lglhm0k8-M0hr"
    },
    "results": {
      "languages": [
        {
          "id": "response-0-200",
          "language": "200",
          "code": "// Returned when successful\n{\n  \"next_page\": \"\",\n  \"items\": [\n    {\n      \"systemId\": \"\",\n      \"code\": \"\",\n      \"title\": \"\",\n      \"clientName\": \"\",\n      \"clientEmail\": \"\",\n      \"rating\": 0,\n      \"agreement\": false,\n      \"signatureType\": false,\n      \"signatureFile\": \"\",\n      \"description\": \"\",\n      \"abortMessage\": \"\",\n      \"clientNote\": \"\",\n      \"clientNoteReply\": \"\",\n      \"distance\": 0,\n      \"workPrice\": 0,\n      \"workPriceWithVat\": 0,\n      \"routePrice\": 0,\n      \"routePriceWithVat\": 0,\n      \"materialPrice\": 0,\n      \"materialPriceWithVat\": 0,\n      \"finalPrice\": 0,\n      \"finalPriceWithVat\": 0,\n      \"vat\": 0,\n      \"currency\": \"\",\n      \"status\": 0,\n      \"stopStatusMessage\": \"\",\n      \"plannedTime\": \"\",\n      \"plannedEndTime\": \"\",\n      \"fixedPlannedTime\": false,\n      \"fetched\": false,\n      \"time\": \"\",\n      \"ended\": \"\",\n      \"pastDue\": false,\n      \"duration\": 0,\n      \"durationFull\": 0,\n      \"billDate\": \"\",\n      \"billStatus\": false,\n      \"reassigned\": false,\n      \"filesExists\": false,\n      \"user\": {\n        \"title\": \"\",\n        \"guid\": \"\",\n        \"systemId\": \"\"\n      },\n      \"formerUser\": {\n        \"title\": \"\",\n        \"guid\": \"\",\n        \"systemId\": \"\"\n      },\n      \"assignor\": {\n        \"title\": \"\",\n        \"guid\": \"\",\n        \"systemId\": \"\"\n      },\n      \"taskType\": {\n        \"title\": \"\",\n        \"guid\": \"\",\n        \"systemId\": \"\"\n      },\n      \"workspace\": {\n        \"title\": \"\",\n        \"serialNumber\": \"\",\n        \"guid\": \"\",\n        \"systemId\": \"\"\n      },\n      \"client\": {\n        \"title\": \"\",\n        \"companyCode\": \"\",\n        \"guid\": \"\",\n        \"systemId\": \"\"\n      },\n      \"createdBy\": {\n        \"title\": \"\",\n        \"guid\": \"\",\n        \"systemId\": \"\"\n      },\n      \"taskRequest\": \"\",\n      \"requireObjectCode\": false,\n      \"requireSignatureCode\": false,\n      \"taskTypePriority\": 0,\n      \"guid\": \"\",\n      \"created\": \"\",\n      \"updated\": \"\",\n      \"version\": 0,\n      \"deleted\": false,\n      \"customValues\": [\n        {\n          \"guid\": \"\",\n          \"value\": \"\"\n        }\n      ],\n      \"literalStatus\": \"\",\n      \"sla\": {\n        \"guid\": \"\",\n        \"systemId\": \"\",\n        \"title\": \"\",\n        \"duration\": 0\n      },\n      \"receivedByExternalSystem\": false,\n      \"helpers\": [\n        {\n          \"title\": \"\",\n          \"guid\": \"\",\n          \"systemId\": \"\"\n        }\n      ],\n      \"tags\": [\n        {}\n      ]\n    }\n  ]\n}"
        },
        {
          "id": "response-1-400",
          "language": "400",
          "code": "// Invalid filter value (pastDue)\n"
        }
      ],
      "selectedLanguageId": "response-0-200"
    }
  },
  "children": [
    {
      "text": ""
    }
  ]
}