Get Enterprise Issue List

POST 
/api/v8/enterprises/:enterprise_id/issues

Request

Path Parameters

enterprise_id stringrequired

Enterprise ID

Query Parameters

access_token stringrequired

User authorization code

application/json

Body

pageinteger
Current page number: defaults to 1
per_pageinteger
The number of items per page, with a maximum of 100. The default is 20.
labelsstring
,
sortstring
Sorting criterion: creation time (created), update time (updated_at). Default: created_at
directionstring
Sort order: asc for ascending, desc for descending. Default: desc
sincestring
The start update time, with the time format required to be ISO 8601.
assigneesstring[]
Administrator's username
milestone_idsinteger[]
Enterprise Milestone ID
project_idsinteger[]
Project ID
create_atstring
Task Creation Date, format: YYYY-MM-DD
created_beforestring
Task creation deadline, format YYYY-MM-DD
searchstring
Search for issue by keyword in title
issue_typesstring[]
issue自定义类型
issue_statesstring[]
Issue Custom Status
custom_fields object[]
Array [
field_namestring
valuesstring[]
operationstringrequired
Operation Type, optional values: search (fuzzy search), greater_equal (greater than or equal to), less_equal (less than or equal to), between (between what), in (exact match)
]

Responses

200

Successful Response

Response Headers

total_count

Total quantity

total_page

Total pages

application/json

Schema

Schema

Array [
idinteger
id
html_urlstring
numberstring
statestring
titlestring
bodystring
user object
Author
idstringrequired
object_idstringrequired
loginstringrequired
namestringrequired
repository object
warehouse information
idintegerrequired
full_namestringrequired
human_namestringrequired
pathstringrequired
namestringrequired
urlstringrequired
assigner objectrequired
object
paasstringrequired
created_atstring
updated_atstring
finished_atstring
deadlinestring
labels object[]
Array [
idintegerrequired
namestringrequired
colorstringrequired
]
issue_statestring
Issue Custom Status
commentsinteger
custom_fields object[]
Custom field of issue
Array [
field_namestringrequired
field_valuesstring[]required
]
issue_typestring
Issue Type
issue_prioritystring
Issue Priority
urlstring
repository_urlstring
visibility_reasonstring
Visibility, public: publicly visible, confidential: confidential, visible to project members, other: visible to project members due to other reasons
related_branchesstring[]
Associated Branch List
linked_pulls object[]
Associated pull_request list
Array [
numberintegerrequired
html_urlstringrequired
user objectrequired
idstringrequired
loginstringrequired
namestringrequired
avatar_urlstringrequired
html_urlstringrequired
idintegerrequired
project_idintegerrequired
titlestringrequired
bodystringrequired
statestringrequired
created_atstringrequired
updated_atstringrequired
merged_atstringrequired
merged_by objectrequired
idstringrequired
loginstringrequired
namestringrequired
avatar_urlstringrequired
html_urlstringrequired
closed_atstringrequired
target_branchstringrequired
source_branchstringrequired
source_project_idintegerrequired
target_project_idintegerrequired
]
]

Example (auto)

[
  {
    "id": 0,
    "html_url": "string",
    "number": "string",
    "state": "string",
    "title": "string",
    "body": "string",
    "user": {
      "id": "string",
      "object_id": "string",
      "login": "string",
      "name": "string"
    },
    "repository": {
      "id": 0,
      "full_name": "string",
      "human_name": "string",
      "path": "string",
      "name": "string",
      "url": "string",
      "assigner": {},
      "paas": "string"
    },
    "created_at": "string",
    "updated_at": "string",
    "finished_at": "string",
    "deadline": "string",
    "labels": [
      {
        "id": 0,
        "name": "string",
        "color": "string"
      }
    ],
    "issue_state": "string",
    "comments": 0,
    "custom_fields": [
      {
        "field_name": "string",
        "field_values": [
          "string"
        ]
      }
    ],
    "issue_type": "string",
    "issue_priority": "string",
    "url": "string",
    "repository_url": "string",
    "visibility_reason": "string",
    "related_branches": [
      "string"
    ],
    "linked_pulls": [
      {
        "number": 0,
        "html_url": "string",
        "user": {
          "id": "string",
          "login": "string",
          "name": "string",
          "avatar_url": "string",
          "html_url": "string"
        },
        "id": 0,
        "project_id": 0,
        "title": "string",
        "body": "string",
        "state": "string",
        "created_at": "string",
        "updated_at": "string",
        "merged_at": "string",
        "merged_by": {
          "id": "string",
          "login": "string",
          "name": "string",
          "avatar_url": "string",
          "html_url": "string"
        },
        "closed_at": "string",
        "target_branch": "string",
        "source_branch": "string",
        "source_project_id": 0,
        "target_project_id": 0
      }
    ]
  }
]

1

Successful Example

{
  "id": 48,
  "name": "Multiple Choice Dropdown",
  "description": "",
  "field_type": "select_multi",
  "field_visibility": 0,
  "created_time": "2025-12-18T14:50:25+08:00",
  "updated_time": "2025-12-18T14:50:25+08:00",
  "options": [
    {
      "id": 51,
      "extend_field_id": 48,
      "sort_num": 9999,
      "field_value": "1",
      "created_time": "2025-12-18T14:50:34+08:00",
      "updated_time": "2025-12-18T14:50:34+08:00"
    },
    {
      "id": 52,
      "extend_field_id": 48,
      "sort_num": 9999,
      "field_value": "2",
      "created_time": "2025-12-18T14:50:36+08:00",
      "updated_time": "2025-12-18T14:50:36+08:00"
    },
    {
      "id": 53,
      "extend_field_id": 48,
      "sort_num": 9999,
      "field_value": "3",
      "created_time": "2025-12-18T14:50:38+08:00",
      "updated_time": "2025-12-18T14:50:38+08:00"
    },
    {
      "id": 54,
      "extend_field_id": 48,
      "sort_num": 9999,
      "field_value": "4",
      "created_time": "2025-12-18T14:50:41+08:00",
      "updated_time": "2025-12-18T14:50:41+08:00"
    }
  ],
  "types": [
    {
      "id": 425,
      "name": "requirement",
      "desc": "",
      "enabled": true,
      "sort_num": 1,
      "kind": 0
    }
  ]
}

2

Successful Example

{
  "id": 47,
  "name": "test3",
  "description": "",
  "field_type": "select_single",
  "field_visibility": 1,
  "created_time": "2025-12-18T10:58:24+08:00",
  "updated_time": "2025-12-18T10:58:24+08:00",
  "options": [
    {
      "id": 49,
      "extend_field_id": 47,
      "sort_num": 9999,
      "field_value": "1",
      "created_time": "2025-12-18T10:58:58+08:00",
      "updated_time": "2025-12-18T10:58:58+08:00"
    },
    {
      "id": 50,
      "extend_field_id": 47,
      "sort_num": 9999,
      "field_value": "2",
      "created_time": "2025-12-18T10:59:02+08:00",
      "updated_time": "2025-12-18T10:59:02+08:00"
    }
  ],
  "types": [
    {
      "id": 425,
      "name": "requirement",
      "desc": "",
      "enabled": true,
      "sort_num": 1,
      "kind": 0
    }
  ]
}

3

Successful Example

{
  "id": 46,
  "name": "test2",
  "description": "1",
  "field_type": "text_single",
  "field_visibility": 1,
  "created_time": "2025-12-18T10:57:54+08:00",
  "updated_time": "2025-12-18T10:57:54+08:00",
  "types": []
}

4

Successful Example

{
  "id": 45,
  "name": "test1",
  "description": "",
  "field_type": "text_single",
  "field_visibility": 0,
  "created_time": "2025-12-18T10:46:51+08:00",
  "updated_time": "2026-01-07T09:22:17+08:00",
  "types": [
    {
      "id": 425,
      "name": "requirement",
      "desc": "",
      "enabled": true,
      "sort_num": 1,
      "kind": 0
    }
  ]
}