# Account Management

Source: /aws/services/account/

## Introduction

Account service provides APIs to manage your AWS account.
You can use the Account APIs to retrieve information about your account, manage your contact information and alternate contacts.
Additionally, you can use the Account APIs to enable or disable a region for your account, and delete alternate contacts in your account.

LocalStack allows you to use the Account API to retrieve information about your account.
The supported APIs are available on our [API Coverage section](#api-coverage), which provides information on the extent of Account's integration with LocalStack.

:::note
LocalStack's Account provider is mock-only and does not support connecting to any real AWS account.
The Account APIs are only intended to demonstrate how you can use and mock the AWS Account APIs in your local environment.
It's important to note that LocalStack doesn't offer a programmatic interface to manage your AWS or your LocalStack account.
:::

## Getting started

This guide is designed for users who are new to Account and assumes basic knowledge of the AWS CLI and our [`lstk aws`](/aws/developer-tools/running-localstack/lstk/cloud-and-iac-commands/#aws) command.

Start your LocalStack container using your preferred method.
We will demonstrate how to put contact information, fetch account details, and attach an alternate contact to your account.

### Put contact information

You can use the [`PutContactInformation`](https://docs.aws.amazon.com/accounts/latest/reference/API_PutContactInformation.html) API to add or update the contact information for your AWS account.
Run the following command to add contact information to your account:

```bash showshowLineNumbers
lstk aws account put-contact-information \
    --contact-information '{
        "FullName": "Jane Doe",
        "PhoneNumber": "+XXXXXXXXX",
        "AddressLine1": "XXXX Main St",
        "City": "XXXX",
        "PostalCode": "XXXXX",
        "CountryCode": "US",
        "StateOrRegion": "WA"
    }'
```

### Fetch account details

You can use the [`GetContactInformation`](https://docs.aws.amazon.com/accounts/latest/reference/API_GetContactInformation.html) API to retrieve the contact information for your AWS account.
Run the following command to fetch the contact information for your account:

```bash
lstk aws account get-contact-information
```

```bash title="Output" showshowLineNumbers
{
    "ContactInformation": {
        "AddressLine1": "XXXX Main St",
        "City": "XXXX",
        "CountryCode": "US",
        "FullName": "Jane Doe",
        "PhoneNumber": "+XXXXXXXXX",
        "PostalCode": "XXXXX",
        "StateOrRegion": "WA"
    }
}
```

### Attach alternate contact

You can attach an alternate contact using [`PutAlternateContact`](https://docs.aws.amazon.com/accounts/latest/reference/API_PutAlternateContact.html) API.
Run the following command to attach an alternate contact to your account:

```bash showshowLineNumbers
lstk aws account put-alternate-contact \
    --alternate-contact-type "BILLING" \
    --email-address "bill@ing.com" \
    --name "Bill Ing" \
    --phone-number "+1 555-555-5555" \
    --title "Billing"
```

## Resource Browser

The LocalStack Web Application provides a Resource Browser for managing contact information & alternate accounts for the Account service.
You can access the Resource Browser by opening the LocalStack Web Application in your browser, navigating to the Resources section, and then clicking on **Account** under the **Management & Governance** section.

![Account Resource Browser](/images/aws/account-resource-browser.png)

The Resource Browser allows you to perform the following actions:

* **Create Contact Information**: Add the contact information for your mocked AWS account by clicking on the **Create** button in the contact information section.
* **Create Alternate Contact**: Add an alternate contact for your mocked AWS account by clicking on the **Create** button in the alternate contacts section.
* **View Contact Information**: View the contact information for your mocked AWS account by clicking on the contact information.
* **Update Contact Information**: Update the contact information for your mocked AWS account by clicking on the contact information.
* **Filter**: Filter the contact information and alternate contacts by types, such as `BILLING`, `OPERATIONS`, and `SECURITY`.

## API Coverage


### AWS Account Management API coverage

Source service: `account`. 6 of 16 tracked operations are implemented.

Service documentation: /aws/services/account/
License availability: available starting with the Ultimate plan. See /aws/licensing/ for current plan details.

| Operation | Status |
| --- | --- |
| AcceptPrimaryEmailUpdate | Not implemented |
| DeleteAlternateContact | Implemented |
| DisableRegion | Not implemented |
| EnableRegion | Not implemented |
| GetAccountInformation | Not implemented |
| GetAlternateContact | Implemented |
| GetContactInformation | Implemented |
| GetGovCloudAccountInformation | Not implemented |
| GetPrimaryEmail | Not implemented |
| GetPrimaryEmailUpdateStatus | Not implemented |
| GetRegionOptStatus | Not implemented |
| ListRegions | Implemented |
| PutAccountName | Not implemented |
| PutAlternateContact | Implemented |
| PutContactInformation | Implemented |
| StartPrimaryEmailUpdate | Not implemented |