Help Center/ Data Security Center/ API Reference/ API Description/ Multi-Account Management/ Obtaining the OU List of an Organization
Updated on 2026-01-13 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Obtaining the OU List of an Organization

Function

This API is used to obtain the organization units (OUs) of an organization in a specified project. Pagination is supported.

Calling Method

For details, see Calling APIs.

URI

GET /v1/{project_id}/multi-accounts/organizational-unit-list

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID, which is used to identify a specific project.
Table 2 Query Parameters

Parameter

Mandatory

Type

Description

account_id

No

String

Account ID, which is used to filter accounts.

limit

No

Integer

Number of records returned on each page.

marker

No

String

Offset of the returned records.

parent_id

No

String

Parent account ID, which is used to filter sub-accounts of a specified parent account.

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

ou_list

Array of OrganizationOU objects

Organization unit list.

page_info

PaginationResponse object

Pagination information.
Table 4 OrganizationOU

Parameter

Type

Description

id

String

Organization unit ID.

name

String

Organization unit name.

ou_list

Array of OrganizationOU objects

Sub-organization unit list.
Table 5 PaginationResponse

Parameter

Type

Description

marker

String

Pagination marker.

total

Integer

Total number of records.

Example Requests

None

Example Responses

None

Status Codes

Status Code

Description

200

Request succeeded. The OU list is returned.

401

Unauthorized access to the resource.

403

Access denied. Insufficient permissions.

404

The requested resource does not exist.

Error Codes

See Error Codes.

Parent topic: Multi-Account Management