Monitor the state of your Amazon Web Services accounts - Amazon Organizations
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Monitor the state of your Amazon Web Services accounts

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

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
To view the state of an Amazon Web Services account
  1. Sign in to the Amazon Organizations console. You must sign in as an IAM user, assume an IAM role, or sign in as the root user (not recommended) in the organization’s management account.

  2. Navigate to the Amazon Web Services 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 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:

  • Amazon CLI:

    • list-accounts – lists the details of all accounts in the organization

    • list-accounts-for-parent – lists the details of all accounts in the organization that are contained by the specified target root or organizational unit (OU)

    • describe-account – 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" } }
  • Amazon SDKs: