Help Center/ CodeArts Req/ API Reference/ API/ Scrum Project Work Items/ Querying Work Item Details

Updated on 2026-10-27 GMT+08:00

Querying Work Item Details

Function

This API is used to query work item details.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account root user has all the permissions required to call all APIs, but IAM users must be assigned the following required identity policy-based permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
codeartsreq:workitem:get	Read	-	codeartsreq:Model codeartsreq:ProjectId	-	-

URI

GET /v4/projects/{project_id}/issues/{issue_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition A 32-character UUID. It uniquely identifies a project. Obtain a project ID by calling the API for querying projects. The value of project_id in the response message body is a project ID. Constraints A string of 32 characters consisting of letters and digits. Range N/A Default Value N/A
issue_id	Yes	Integer	Definition Work item ID, which can be obtained from the API for performing advanced query of work items. The value of the id field in the response body is the work item ID. Constraints N/A Range ≥ 0 Default Value N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
accessories	Array of IssueAccessory objects	Definition: Attachment list.
actual_work_hours	Double	Definition: Actual workloads. Options: Minimum value: 0.
assigned_cc_user	Array of IssueUser objects	Definition: Cc recipient.
assigned_user	IssueUser object	Definition: Handler.
begin_time	String	Definition: Estimated start time. The format is YYYY-MM-DD. Options: N/A
closed_time	String	Definition: Closing time. The format is YYYY-MM-DD HH:MM:SS. Options: N/A
created_time	String	Definition: Creation time. The format is YYYY-MM-DD HH:MM:SS. Options: N/A
creator	IssueUser object	Definition: Creator.
custom_fields	Array of CustomField objects	Definition: Custom property value, which is not recommended. Refer to the new_custom_fields field.
description	String	Definition: Work item description. Options: N/A
developer	IssueUser object	Definition: Developer.
domain	domain object	Parameter description: Domain.
done_ratio	Integer	Definition Work item completion percentage. For example, 20 indicates a completion of 20%. Range 0–100
end_time	String	Definition: Estimated end time. The format is YYYY-MM-DD. Options: N/A
expected_work_hours	Double	Parameter description: Estimated workloads. Options: Minimum value: 0.
id	Integer	Definition Work item ID. Range 0 to 9999999999
iteration	iteration object	Parameter description: Sprint.
module	module object	Parameter description: Module.
name	String	Parameter description: Title. Options: N/A
order	IssueOrder object	Definition: Sorting order.
parent_issue	parent_issue object	Definition: Parent work item.
priority	priority object	Definition: Work item priority.
project	IssueProjectResponseV4 object	Definition: Project information.
severity	severity object	Definition: Work item severity.
status	status object	Definition: Work item status.
story_point	story_point object	Definition: Story point.
tracker	tracker object	Definition: Work item type.
updated_time	String	Parameter description: Update time. The format is YYYY-MM-DD HH:MM:SS. Options: N/A
new_custom_fields	Array of IssueDetailCustomField objects	Parameter description: Custom property value.
find_release_dev	String	Definition Version number. Range N/A
release_dev	String	Definition Release version number. Range N/A
env	IssueAttribute object	Definition Environment. Range N/A
tag_list	Array of TagRelation objects	Definition Tag list. Range N/A

**Table 3** IssueAccessory
Parameter	Type	Description
id	Integer	Definition Primary key ID. Range N/A
project_id	String	Definition Project ID. Range N/A
container_id	Integer	Definition Container ID. Range N/A
attachment_id	Integer	Definition Attachment ID. Range N/A
container_type	String	Definition Container type. Range Issue.
created_time	String	Definition Time when the attachment was created. The value is in the format of YYYY-MM-DD HH:MM:SS. Range N/A
creator_id	String	Definition Creator user UUID. Range N/A
creator_num_id	Integer	Definition: Digital ID of the creator. Options: N/A
digest	String	Definition: Abstract. Options: N/A
disk_directory	String	Definition: Attachment path. Options: N/A
disk_file_name	String	Definition: Attachment name. Options: N/A
file_name	String	Definition: Name of the file to be uploaded. Options: N/A
issue_id	Integer	Definition: Work item ID. Options: N/A

**Table 4** IssueUser
Parameter	Type	Description
id	Integer	Definition User ID. Range N/A
name	String	Definition Username. Range N/A
nick_name	String	Definition: Alias. Options: N/A
user_id	String	Definition User UUID. Range N/A
user_num_id	Integer	Definition Digital ID of a user. Range N/A
first_name	String	Definition: Username. Value range: N/A

**Table 5** CustomField
Parameter	Type	Description
name	String	Definition: Custom property name. Value range: N/A
new_name	String	Definition: Custom property name. Value range: N/A
value	String	Definition: Value of the custom property. Value range: N/A

**Table 6** domain
Parameter	Type	Description
id	Integer	Definition: Domain ID. The options are as follows: 14: performance 15: function 16: reliability 17: cyber security 18: maintainability 19: other DFX 20: availability Value range: 14, 15, 16, 17, 18, 19, and 20
name	String	Parameter description: Domain name. Options: N/A

**Table 7** iteration
Parameter	Type	Description
id	Integer	Definition Sprint ID. Range Min.: 0.
name	String	Parameter description: Sprint name. Options: N/A

**Table 8** module
Parameter	Type	Description
id	Integer	Definition Module ID. Range Min.: 0.
name	String	Parameter description: Module name. Options: N/A

**Table 9** IssueOrder
Parameter	Type	Description
id	Integer	Definition: Sequence ID. Options: Minimum value: 0.
name	String	Definition: Sequence value. Options: N/A

**Table 10** parent_issue
Parameter	Type	Description
id	Integer	Definition Parent work item ID. Range Min.: 0.
name	String	Parameter description: Parent work item name. Options: N/A

**Table 11** priority
Parameter	Type	Description
id	Integer	Parameter description: Priority ID. The options are as follows: 1: low 2: medium 3: high Options: 1, 2, and 3
name	String	Parameter description: Priority. Options: N/A

**Table 12** IssueProjectResponseV4
Parameter	Type	Description
project_id	String	Definition Project ID. Range N/A
project_name	String	Definition: Project name. Value range: N/A
project_num_id	Integer	Definition Digital ID of a project. Range ≥ 0

**Table 13** severity
Parameter	Type	Description
id	Integer	Parameter description: Severity ID. The options are as follows: 10: critical 11: major 12: minor 13: info Options: 10, 11, 12, and 13
name	String	Definition: Severity. Options: N/A

**Table 14** status
Parameter	Type	Description
id	Integer	Parameter description: Status ID. The options are as follows: 1: initial 2: in progress 3: solved 4: testing 5: closed 6: rejected Options: 1, 2, 3, 4, 5, and 6
name	String	Parameter description: Status name. Options: N/A

**Table 15** story_point
Parameter	Type	Description
id	Integer	Definition Story point ID. A story point is an agile method for estimating workloads. It can be regarded as the development cost, which takes into account the required efforts for story delivery, development complexity, and risks. Story point values corresponding to story point IDs: 1: 0 2: 1/2 3: 1 4: 2 5: 3 6: 5 7: 8 8: 13 9: 21 10: 40 11: 80 12: 100 Range 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12
name	String	Definition: Story point name. Options: N/A

**Table 16** tracker
Parameter	Type	Description
id	Integer	Definition: Type ID. The options are as follows: 2 (task) 3 (bug) 5 (epic) 6 (feature) 7 (story) Options: 2, 3, 5, 6, and 7
name	String	Parameter description: Type name. Options: N/A

**Table 17** IssueDetailCustomField
Parameter	Type	Description
custom_field	String	Parameter description: Custom field. You can obtain the custom_field value returned using the [Querying Custom Fields of a Scrum Work Item]ListIssueCustomFields.xml) API.
field_name	String	Definition: Values of custom properties. Use commas (,) to separate multiple values, which can be obtained by querying the name value returned when calling the Querying Custom Fields of a Scrum Work Item API.
value	String	Definition: Values of custom properties. Use commas (,) to separate multiple values. You can obtain the value by querying the options value returned when calling the Querying Custom Fields of a Scrum Work Item API.
description	String	Definition: Custom field description. Options: N/A
field_type	String	Definition: Custom field type. Value range: textArea: multi-line text text: single-line text select: drop-down list number: number time_date: date checkbox: check box radio: radio button

**Table 18** IssueAttribute
Parameter	Type	Description
id	Integer	Definition Environment ID. Range N/A
name	String	Definition Environment name. Range N/A

**Table 19** TagRelation
Parameter	Type	Description
relationId	Integer	Definition Association ID. Range N/A
tagId	Integer	Definition Tag ID. Range N/A
region	String	Definition Region. Range N/A
name	String	Definition Tag name. Range N/A

Status code: 400

**Table 20** Response body parameters
Parameter	Type	Description
error_code	String	Definition: Error code. Value range: N/A
error_msg	String	Definition: Error description. Value range: N/A

Status code: 401

**Table 21** Response body parameters
Parameter	Type	Description
error_code	String	Definition: Error code. Value range: N/A
error_msg	String	Definition: Error description. Value range: N/A
request_id	String	Definition Request ID, which is automatically generated by the system. Range N/A

Example Requests

GET https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/issues/4568921

Example Responses

Status code: 200

{
  "id" : 1377841,
  "name" : "testAPI",
  "done_ratio" : 0,
  "tracker" : {
    "id" : 3,
    "name" : "Bug"
  },
  "priority" : {
    "id" : 2,
    "name" : "Medium"
  },
  "security_level" : null,
  "order" : {
    "id" : 1,
    "name" : "1"
  },
  "severity" : {
    "id" : 12,
    "name" : "Minor"
  },
  "status" : {
    "id" : 1,
    "name" : "Initial"
  },
  "release_dev" : "",
  "find_release_dev" : "",
  "env" : null,
  "updated_time" : "2026-06-30 16:57:45",
  "begin_time" : "2025-12-17",
  "end_time" : "2025-12-31",
  "project" : {
    "project_num_id" : 527,
    "project_id" : "ddb260aa69b848599747eadfa632a40f",
    "project_name" : "Scrum0630001"
  },
  "parent_issue" : {
    "id" : 1377839,
    "name" : "story111"
  },
  "module" : null,
  "domain" : null,
  "iteration" : null,
  "story_point" : null,
  "expected_work_hours" : 0,
  "actual_work_hours" : 0,
  "created_time" : "2026-06-30 16:57:45",
  "custom_fields" : [ ],
  "new_custom_fields" : [ ],
  "assigned_cc_user" : null,
  "assigned_user" : {
    "user_id" : null,
    "user_num_id" : null,
    "id" : 83,
    "name" : "CodeArtsReq_creq_chm1",
    "nick_name" : "creq_chm1",
    "first_name" : "creq_chm1"
  },
  "creator" : {
    "user_id" : null,
    "user_num_id" : null,
    "id" : 83,
    "name" : "CodeArtsReq_creq_chm1",
    "nick_name" : "creq_chm1",
    "first_name" : "creq_chm1"
  },
  "developer" : {
    "user_id" : null,
    "user_num_id" : null,
    "id" : 83,
    "name" : "CodeArtsReq_creq_chm1",
    "nick_name" : "creq_chm1",
    "first_name" : "creq_chm1"
  },
  "closed_time" : null,
  "tag_list" : null,
  "accessories" : null,
  "description" : "<h1 class=\"ql-align-center\">aaaaaaaa</h1>"
}

SDK Sample Code

The SDK sample code is as follows.

Java

     package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.projectman.v4.region.ProjectManRegion;
import com.huaweicloud.sdk.projectman.v4.*;
import com.huaweicloud.sdk.projectman.v4.model.*;


public class ShowIssueV4Solution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");

        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);

        ProjectManClient client = ProjectManClient.newBuilder()
                .withCredential(auth)
                .withRegion(ProjectManRegion.valueOf("<YOUR REGION>"))
                .build();
        ShowIssueV4Request request = new ShowIssueV4Request();
        request.withProjectId("{project_id}");
        request.withIssueId({issue_id});
        try {
            ShowIssueV4Response response = client.showIssueV4(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}
 
 
  

Python

     # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkprojectman.v4.region.projectman_region import ProjectManRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkprojectman.v4 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]

    credentials = BasicCredentials(ak, sk)

    client = ProjectManClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(ProjectManRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ShowIssueV4Request()
        request.project_id = "{project_id}"
        request.issue_id = {issue_id}
        response = client.show_issue_v4(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)
 
 
  

Go

     package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    projectman "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/projectman/v4"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/projectman/v4/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/projectman/v4/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")

    auth, err := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        SafeBuild()

    if err != nil {
        fmt.Println(err)
        return
    }

    hcClient, err := projectman.ProjectManClientBuilder().
         WithRegion(region.ValueOf("<YOUR REGION>")).
         WithCredential(auth).
         SafeBuild()


    if err != nil {
        fmt.Println(err)
        return
    }

    client := projectman.NewProjectManClient(hcClient)

    request := &model.ShowIssueV4Request{}
	request.ProjectId = "{project_id}"
	request.IssueId = int32({issue_id})
	response, err := client.ShowIssueV4(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}
 
 
  

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

Status Codes

Status Code	Description
200	OK
400	Bad Request
401	Unauthorized

Error Codes

See Error Codes.

Parent topic: Scrum Project Work Items

Previous topic: Querying the Work Item Transfer Configuration of a Scrum Project

Next topic: Updating a Work Item