Help Center/Organizations/API Reference/APIs/Managing Accounts/Querying Account Creation Status
Updated on 2026-03-05 GMT+08:00
View PDF

Querying Account Creation Status

Function

This API is used to query the status of the asynchronous request to create an account. This API can be called only from the organization's management account or a delegated administrator account.

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:createAccountStatuses:get

    Read

    -

    -

    -

    -

URI

GET /v1/organizations/create-account-status/{create_account_status_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

create_account_status_id

Yes

String

ID value that uniquely identifies a CreateAccount request.

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

create_account_status

CreateAccountStatusDto object

States of CreateAccount requests for an organization.

Table 4 CreateAccountStatusDto

Parameter

Type

Description

account_id

String

Unique ID of the newly created account if any.

account_name

String

Account name.

completed_at

String

Date and time when the account was created and the request was completed.

created_at

String

Date and time when the CreateAccount request was made.

id

String

Unique ID of a request. You can get this value from the response to the initial CreateAccount request.

state

String

Status of the asynchronous request for creating an account.

failure_reason

String

Error 1000: Failed to query the user identity information.

Error 2000: Failed to create the account.

Error 2001: Account name conflict.

Error 3000: Failed to create the resource account.

Error 3001: This phone number has reached the maximum account registration limit.

Error 4000: Failed to create the birth token.

Error 5000: Failed to create the service-linked agency.

Error 6000: Failed to create the agency.

Error 6001: Failed to query the permission information.

Error 6002: Failed to bind the permission information.

Error 7000: Failed to associate the master account with member accounts for unified accounting.

Error 7001: Too many real-name authentication records.

Error 7002: Failed to query the financial association between the master account and member accounts.

Error 0000: System error.

failure_detail_msg

failure_detail_msg object

Detailed reason why the request fails.

Table 5 failure_detail_msg

Parameter

Type

Description

error_msg

String

Transparently Transmitting Error Codes

encoded_authorization_message

String

Transparently Transmitting Authentication Failure Information

Example Requests

Querying account creation status

GET https://{endpoint}/v1/organizations/create-account-status/{create_account_status_id}

Example Responses

Status code: 200

Successful

{
  "create_account_status" : {
    "account_id" : "0a6d25d23900d45c0faac010e0fb4de0",
    "account_name" : "paas_iam_573331",
    "completed_at" : "2022-08-24T06:41:15Z",
    "created_at" : "2022-08-24T06:41:15Z",
    "id" : "h-awjp43m7bz3b8jgy5v61jrfwakt3og8w",
    "state" : "in_progress",
    "failure_reason" : "string"
  }
}

Status Codes

Status Code

Description

200

Successful

Error Codes

See Error Codes.

Parent topic:Managing Accounts