Help Center/ Organizations/ API Reference/ APIs/ Managing OUs/ Getting OU Information

Updated on 2025-11-12 GMT+08:00

View PDF

Getting OU Information

Function

This API is used to get OU information. It can be called only from the organization's management account or from a member account that is a delegated administrator for a cloud service.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
organizations:ous:get	Read	ou *	g:ResourceTag/<tag-key>	-	-

URI

GET /v1/organizations/organizational-units/{organizational_unit_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
organizational_unit_id	Yes	String	Unique ID of an OU.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Security-Token	No	String	Security token (session token) of your temporary security credentials. If a temporary security credential is used, this header is required.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
organizational_unit	OrganizationalUnitDto object	Details about a newly created organizational unit (OU).

**Table 4** OrganizationalUnitDto
Parameter	Type	Description
id	String	Unique ID of an OU.
urn	String	Uniform resource name of the OU.
name	String	OU name.
created_at	String	Time when the OU was created.

Example Requests

Getting OU Information

GET https://{endpoint}/v1/organizations/organizational-units/{organizational_unit_id}

Example Responses

Status code: 200

Successful

{
  "organizational_unit" : {
    "id" : "ou-taowxgy4xbme6m4x3c2iijbxw7yj8fcw",
    "urn" : "organizations::0a6d25d23900d45c0faac010e0fb4de0:ou:o-fhkmi6mek7wlqdp6nideqhb47qwtjdsv/ou-taowxgy4xbme6m4x3c2iijbxw7yj8fcw",
    "name" : "autoOU0923152729270Pkgk",
    "created_at" : "2022-09-23T07:27:28Z"
  }
}