All Products
Search
Document Center

DataWorks:ListBusiness

Last Updated:Jan 12, 2026

Queries a list of workflows.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ProjectIdlongNo

The DataWorks workspace ID. You can log on to the DataWorks console and go to the Workspace page to query the ID. You must specify either this parameter or the ProjectIdentifier parameter to identify the DataWorks workspace when you call this operation.

10000
ProjectIdentifierstringNo

The name of the DataWorks workspace. You can log on to the DataWorks console and go to the Workspace page to query the workspace name. You must specify either this parameter or the ProjectId parameter to identify the DataWorks workspace when you call this operation.

dw_project
PageNumberintegerYes

The requested page number, used for pagination.

1
PageSizeintegerYes

The number of records per page. Default: 10. Maximum: 100.

10
KeywordstringNo

The keyword, used for fuzzy match of workflow names.

my

Response parameters

ParameterTypeDescriptionExample
object

Responses.

HttpStatusCodeinteger

The HTTP status code.

200
ErrorMessagestring

The error message.

The connection does not exist.
RequestIdstring

The request ID. Used for troubleshooting when an error occurs.

0000-ABCD-EFG****
ErrorCodestring

The error code.

Invalid.Tenant.ConnectionNotExists
Successboolean

Indicates whether the request was successful.

true
Dataobject

Details of workflows.

PageNumberinteger

The current page number.

1
PageSizeinteger

The number of records on the current page.

10
TotalCountinteger

The total number of records that meet the query conditions.

13
Businessarray<object>

Information about the workflow list.

Businessobject

Information about the workflow list.

Ownerstring

The owner of the workflow.

34824327****
Descriptionstring

The description of the workflow.

test
ProjectIdlong

The ID of the workspace to which the workflow belongs.

10000
BusinessIdlong

The workflow ID.

3000001
BusinessNamestring

The name of the workflow.

test
UseTypestring

The module to which the workflow belongs. Valid values: NORMAL (Data Studio) and MANUAL_BIZ (Manually Triggered Workflow).

NORMAL

Examples

Sample success responses

JSONformat

{
  "HttpStatusCode": 200,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "0000-ABCD-EFG****",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true,
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 13,
    "Business": [
      {
        "Owner": "34824327****",
        "Description": "test",
        "ProjectId": 10000,
        "BusinessId": 3000001,
        "BusinessName": "test",
        "UseType": "NORMAL"
      }
    ]
  }
}

Error codes

HTTP status codeError codeError messageDescription
403Forbidden.AccessAccess is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.No permission, please authorize
429Throttling.ApiThe request for this resource has exceeded your available limit.-
429Throttling.SystemThe DataWorks system is busy. Try again later.-
429Throttling.UserYour request is too frequent. Try again later.-
500InternalError.SystemAn internal system error occurred. Try again later.-
500InternalError.UserId.MissingAn internal system error occurred. Try again later.-

For a list of error codes, visit the Service error codes.