---
title: "POST /subscriptions/{subscriptionId}/providers/Microsoft.Storage/checkNameAvailability"
method: POST
path: "/subscriptions/{subscriptionId}/providers/Microsoft.Storage/checkNameAvailability"
tags: ["StorageAccounts"]
---

# POST /subscriptions/{subscriptionId}/providers/Microsoft.Storage/checkNameAvailability

`POST /subscriptions/{subscriptionId}/providers/Microsoft.Storage/checkNameAvailability`

Checks that the storage account name is valid and is not already in use.

## Parameters

- `../../../../../common-types/resource-management/v1/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref
- `../../../../../common-types/resource-management/v1/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref

## Request body

- StorageAccountCheckNameAvailabilityParameters — The parameters used to check the availability of the storage account name.
  - `name` string, required — The storage account name.
  - `type` 'Microsoft.Storage/storageAccounts', required — The type of resource, Microsoft.Storage/storageAccounts

## Response `200`

OK -- Operation to check the storage account name availability was successful.

- CheckNameAvailabilityResult — The CheckNameAvailability operation response.
  - `nameAvailable` boolean — Gets a boolean value that indicates whether the name is available for you to use. If true, the name is available. If false, the name has already been taken or is invalid and cannot be used.
  - `reason` 'AccountNameInvalid' | 'AlreadyExists' — Gets the reason that a storage account name could not be used. The Reason element is only returned if NameAvailable is false.
  - `message` string — Gets an error message explaining the Reason value in more detail.

---

[API](https://skmtc.dev/azure/apis/storagemanagementclient-4.md) · [All operations](https://skmtc.dev/azure/apis/storagemanagementclient-4/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/storagemanagementclient-4/revisions/becfd60efe69/schema)