---
title: "Get Task List for a Job"
slug: "gettaskforajob"
updated: 2026-04-15T06:26:18Z
published: 2026-04-15T06:26:18Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.12dsynergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Task List for a Job

This tutorial demonstrates how to search for a task via RESTful API.

It is similar to the [Searching for a task](/v1/docs/searchtaskdoc) procedure. The difference is that the job ID is being input as a query parameter in the URL.

The commands are provided in curl and can be run from the command prompt when the 12d Synergy Server is running (or in a batch script).

> [!NOTE]
> Additional API documentation
> 
> To get a list of most of the API requests available, with the 12d Synergy server running, browse [http://synergy.myserver.com/api-docs/ui/index](http://localhost:8080/api-docs/ui/index).
> 
> (Replace [synergy.myserver.com](http://synergy.myserver.com/) with the external server address and update the port numbers if necessary.)

### 1.1. Getting the Personal Access Token to access API

The tutorial for getting the PAT is here: [Generate PAT in Web client](/v1/docs/webclientgenerateapersonalaccesstokenpatinwebclientdoc).

### 1.2. Getting the Job ID

Refer to [Search Jobs](/v1/docs/searchjobsdoc) to get the required job ID.

After getting the Job ID, it can now be input into the API request.

### 1.3. Getting a Task List for a Job

This request is available in the API Documentation under Tasks,****marked 'Get task list for a job'.

**Sample Request**

```SampleRequest
curl --location 'http://localhost:8080/api/v1/tasks/getTaskList?job_id={job-id-here}' \

--header 'Authorization: Bearer <your-token-here>' \

--header 'Content-Type: application/json' \
```

Below is a sample response for the tasks of a specific job. Click ![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/expand.png) in the line below to see the code.

****Sample Response****

```SampleResponse
[

    {

        "due_date_mode": 0,

        "start_date_mode": 0,

        "id": {

            "_id": 3,

            "_server_id": 1,

            "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

            "IDString": "3_1"

        },

        "item_id": {

            "_id": 3,

            "_server_id": 1,

            "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

            "IDString": "3_1"

        },

        "project_id": {

            "_id": 1,

            "_server_id": 1,

            "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

            "IDString": "1_1"

        },

        "parent_item_id": null,

        "name": "Enquiry - Follow Up",

        "description": "",

        "progress": 0,

        "AllProgress": 0,

        "priority": 0,

        "task_state": {

            "is_closure": 0,

            "id": {

                "_id": 1,

                "_server_id": 1,

                "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

                "IDString": "1_1"

            },

            "name": "Not Started",

            "sort_order": 1,

            "attributes": [],

            "completion_percentage": null

        },

        "task_state_name": "Not Started",

        "is_closed": false,

        "assigned_entity": null,

        "assigned_by": null,

        "item_owner": {

            "id": {

                "_id": 1,

                "_server_id": 1,

                "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

                "IDString": "1_1"

            },

            "is_user": true,

            "companies": null,

            "first_name": "test",

            "last_name": "test",

            "email": "test@test.com",

            "active": true,

            "create_date": "2024-12-10T01:48:00.25",

            "attributes": [],

            "image_modified_date_time": "2025-04-07T01:05:35.743"

        },

        "history": null,

        "due_date_utc": null,

        "relative_due_date_days": 0,

        "start_date_utc": null,

        "relative_start_date_days": 0,

        "children": [],

        "user_task_id": null,

        "depends_on_ids": [],

        "version": 1,

        "attributes": [],

        "task_type_id": {

            "_id": 1,

            "_server_id": 1,

            "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

            "IDString": "1_1"

        },

        "task_type": {

            "task_type_id": {

                "_id": 1,

                "_server_id": 1,

                "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

                "IDString": "1_1"

            },

            "name": "Generic",

            "colour": "#000000",

            "description": "The generic task type",

            "created_by_id": null,

            "create_date_utc": "2024-12-10T01:48:00.287",

            "dependent_task_action": null,

            "start_task_action": null,

            "workflow_id": null,

            "id": {

                "_id": 1,

                "_server_id": 1,

                "_server_guid": "b993c729-bf98-490c-989d-5621e3b48139",

                "IDString": "1_1"

            },

            "attributes": [],

            "Type": 56

        },

        "task_path": "Test//Enquiry - Follow Up",

        "project_path": "Test",

        "dependent_task_action": null,

        "start_task_action": null,

        "order": 0,

        "colour": "#000000",

        "AssociatedEntities": null,

        "workflow_capture_data": null,

        "DueDays": "Not set",

        "StartDays": "Not set",

        "AssignedContacts": [],

        "Dependencies": null,

        "Reminders": null,

        "CCs": null,

        "Type": 18,

        "change_message": null

    }

]
```