Monitor the state of your AWS accounts
AWS 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 AWS Organizations console or programmatically through AWS Organizations APIs. This enables you to track where each AWS 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 AWS accounts:
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 AWS services and resources normally according to the account's permissions and organization policies. Regular AWS activities such as launching resources, managing services, and incurring charges can occur in this state. |
SUSPENDED |
In this state, the account is unusable because AWS has restricted access. The account holder can still view billing information and contact 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 AWS services while the closure request is processed. After AWS 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 AWS and is displayed next to the account name in the AWS Organizations console for 90 days after closure is initiated. During this period, you cannot access AWS services, but you can contact 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 AWS Organizations console. |
View the state of an AWS account
You can view the account state information by using either the AWS Organizations console or
programmatically using the DescribeAccount
, ListAccounts
, and
ListAccountsForParent
APIs.
Important
The account Status
parameter in AWS Organizations will be retired on September
9, 2026. Although both the account State
and account
Status
parameters are currently available in the AWS 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.