:doc:`Organizations <../../organizations>` / Client / describe_account

****************
describe_account
****************



.. py:method:: Organizations.Client.describe_account(**kwargs)

  

  Retrieves Organizations-related information about the specified account.

   

  You can only call this operation from the management account or a member account that is a delegated administrator.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/organizations-2016-11-28/DescribeAccount>`_  


  **Request Syntax**
  ::

    response = client.describe_account(
        AccountId='string'
    )
    
  :type AccountId: string
  :param AccountId: **[REQUIRED]** 

    The unique identifier (ID) of the Amazon Web Services account that you want information about. You can get the ID from the  ListAccounts or  ListAccountsForParent operations.

     

    The `regex pattern <http://wikipedia.org/wiki/regex>`__ for an account ID string requires exactly 12 digits.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'Account': {
              'Id': 'string',
              'Arn': 'string',
              'Email': 'string',
              'Name': 'string',
              'Status': 'ACTIVE'|'SUSPENDED'|'PENDING_CLOSURE',
              'State': 'PENDING_ACTIVATION'|'ACTIVE'|'SUSPENDED'|'PENDING_CLOSURE'|'CLOSED',
              'JoinedMethod': 'INVITED'|'CREATED',
              'JoinedTimestamp': datetime(2015, 1, 1)
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Account** *(dict) --* 

        A structure that contains information about the requested account.

         

        .. warning::

           

          The ``Status`` parameter in the API response will be retired on September 9, 2026. Although both the account ``State`` and account ``Status`` parameters are currently available in the 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.

          

        
        

        - **Id** *(string) --* 

          The unique identifier (ID) of the account.

           

          The `regex pattern <http://wikipedia.org/wiki/regex>`__ for an account ID string requires exactly 12 digits.

          
        

        - **Arn** *(string) --* 

          The Amazon Resource Name (ARN) of the account.

           

          For more information about ARNs in Organizations, see `ARN Formats Supported by Organizations <https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsorganizations.html#awsorganizations-resources-for-iam-policies>`__ in the *Amazon Web Services Service Authorization Reference*.

          
        

        - **Email** *(string) --* 

          The email address associated with the Amazon Web Services account.

           

          The `regex pattern <http://wikipedia.org/wiki/regex>`__ for this parameter is a string of characters that represents a standard internet email address.

          
        

        - **Name** *(string) --* 

          The friendly name of the account.

           

          The `regex pattern <http://wikipedia.org/wiki/regex>`__ that is used to validate this parameter is a string of any of the characters in the ASCII character range.

          
        

        - **Status** *(string) --* 

          The status of the account in the organization.

           

          .. warning::

             

            The ``Status`` parameter in the ``Account`` object will be retired on September 9, 2026. Although both the account ``State`` and account ``Status`` parameters are currently available in the 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.

            

          
        

        - **State** *(string) --* 

          Each state represents a specific phase in the account lifecycle. Use this information to manage account access, automate workflows, or trigger actions based on account state changes.

           

          For more information about account states and their implications, see `Monitor the state of your Amazon Web Services accounts <https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_account_state.html>`__ in the *Organizations User Guide*.

          
        

        - **JoinedMethod** *(string) --* 

          The method by which the account joined the organization.

          
        

        - **JoinedTimestamp** *(datetime) --* 

          The date the account became a part of the organization.

          
    
  
  **Exceptions**
  
  *   :py:class:`Organizations.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`Organizations.Client.exceptions.AccountNotFoundException`

  
  *   :py:class:`Organizations.Client.exceptions.AWSOrganizationsNotInUseException`

  
  *   :py:class:`Organizations.Client.exceptions.InvalidInputException`

  
  *   :py:class:`Organizations.Client.exceptions.ServiceException`

  
  *   :py:class:`Organizations.Client.exceptions.TooManyRequestsException`

  

  **Examples**

  The following example shows a user in the master account (111111111111) asking for details about account 555555555555:
  ::

    response = client.describe_account(
        AccountId='555555555555',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'Account': {
            'Arn': 'arn:aws:organizations::111111111111:account/o-exampleorgid/555555555555',
            'Email': 'anika@example.com',
            'Id': '555555555555',
            'Name': 'Beta Account',
        },
        'ResponseMetadata': {
            '...': '...',
        },
    }

  