

# Monitor the state of your Amazon Web Services accounts
<a name="orgs_manage_accounts_account_state"></a>

Amazon Organizations provides a way to quickly assess the health and operational status of all accounts in your organization. You can view this information using the **State** column within the Amazon Organizations console or programmatically through Amazon Organizations APIs. This enables you to track where each Amazon Web Services account is in its life cycle, from creation through closure.

Continuous tracking of account state provides the following benefits:
+ Quickly identify accounts that require attention or action
+ Streamline your account management processes
+ Make informed decisions about resource allocation and access control
+ Maintain better overall security and compliance across your organization

The table below describes the five possible account states and their implications for your Amazon Web Services accounts:


**Account states**  

| State | Description | 
| --- | --- | 
| PENDING ACTIVATION | In this state, the account is unusable because the account sign-up process was initiated but never completed. The account holder must complete the remaining sign-up steps, such as providing phone verification or payment information. After completing these steps, the account transitions to the ACTIVE state.  | 
| ACTIVE | This state indicates that the account is fully operational and available. Users can access Amazon services and resources normally according to the account's permissions and organization policies. Regular Amazon activities such as launching resources, managing services, and incurring charges can occur in this state. | 
| SUSPENDED | In this state, the account is unusable because Amazon has restricted access. The account holder can still view billing information and contact Amazon Web Services Support, who can explain why the account is suspended. | 
| PENDING CLOSURE | This temporary state indicates an active request to close the account, but the closure process is not yet complete. The account remains functional and can still be used to access Amazon services while the closure request is processed. After Amazon processes the closure request, the account transitions to the CLOSED state. | 
| CLOSED | This state indicates that the account was closed at the request of the account holder or by Amazon and is displayed next to the account name in the Amazon Organizations console for 90 days after closure is initiated. During this period, you cannot access Amazon services, but you can contact Amazon Web Services Support to reinstate the account or recover important data. After the 90-day post-closure period has elapsed, the account is permanently closed and will no longer be displayed in the Amazon Organizations console. | 

## View the state of an Amazon Web Services account
<a name="view_account_state"></a>

You can view the account state information by using either the Amazon Organizations console or programmatically using the `DescribeAccount`, `ListAccounts`, and `ListAccountsForParent` APIs.

**Important**  
The account `Status` parameter in Amazon Organizations will be retired on September 9, 2026. Although both the account `State` and account `Status` parameters are currently available in the Amazon Organizations APIs (`DescribeAccount`, `ListAccounts`, `ListAccountsForParent`), we recommend that you update your scripts or other code to use the `State` parameter instead of `Status` before September 9, 2026.

------
#### [ Amazon Web Services Management Console ]<a name="view_account_state_procedure"></a>

**To view the state of an Amazon Web Services account**

1. Sign in to the [Amazon Organizations console](https://console.amazonaws.cn/organizations/v2). You must sign in as an IAM user, assume an IAM role, or sign in as the root user ([not recommended](https://docs.amazonaws.cn/IAM/latest/UserGuide/best-practices.html#lock-away-credentials)) in the organization’s management account.

1. Navigate to the **[Amazon Web Services accounts](https://console.amazonaws.cn/organizations/v2/home/accounts)** page and notice the value in the **State** column next to the member account you want to examine. If the account that you want to see is a child of an OU, you might have to choose the triangle icon ![Right-pointing triangle icon.](http://docs.amazonaws.cn/en_us/organizations/latest/userguide/images/console-expand.png)next to an OU to expand it and see its children. Repeat until you find the account.
**Note**  
You can also view the value of the **State** field from the **Account details** page in the Amazon Organizations console.

------
#### [ Amazon CLI & Amazon SDKs ]

**To view the state of an Amazon Web Services account**  
You can use the following commands to view an account's state:

**Note**  
To view account state values in API responses, use Amazon CLI version 2.29.0 or later, or an SDK version released after September 9, 2025. We recommend using the latest Amazon CLI or SDK version as a best practice. For more information, see [Amazon SDKs and Tools version lifecycle](https://docs.amazonaws.cn/sdkref/latest/guide/version-support-matrix.html) in the *Amazon SDKs and Tools Reference Guide*.
+ Amazon CLI:
  +  [list-accounts](https://docs.amazonaws.cn/cli/latest/reference/organizations/list-accounts.html) – lists the details of *all* accounts in the organization
  +  [list-accounts-for-parent](https://docs.amazonaws.cn/cli/latest/reference/organizations/list-accounts-for-parent.html) – lists the details of *all* accounts in the organization that are contained by the specified target root or organizational unit (OU)
  +  [describe-account](https://docs.amazonaws.cn/cli/latest/reference/organizations/describe-account.html) – lists the details of only the specified account

  These commands return the same details for each account included in the response.

  The following example shows how to retrieve the details about a specified account including its `State` value.

  ```
  $ aws organizations describe-account --account-id 123456789012
  
  {
      "Account": {
          "Id": "123456789012",
          "Arn": "arn:aws-cn:organizations::123456789012:account/o-aa111bb222/123456789012",
          "Email": "admin@example.com",
          "Name": "Example.com Organization's Management Account",
          "State": "CLOSED",
          "Status": "SUSPENDED",
          "JoinedMethod": "INVITED",
          "JoinedTimestamp": "2020-11-20T09:04:20.346000-08:00",
          "Paths": [
              "o-aa111bb222/r-a1b2/123456789012/"
          ]
      }
  }
  ```
+ Amazon SDKs:
  + [ListAccounts](https://docs.amazonaws.cn/organizations/latest/APIReference/API_ListAccounts.html)
  + [ListAccountsForParent](https://docs.amazonaws.cn/organizations/latest/APIReference/API_ListAccountsForParent.html)
  + [DescribeAccount](https://docs.amazonaws.cn/organizations/latest/APIReference/PI_DescribeAccount.html)

------