---
title: "Check if a provisioning service name is available."
method: POST
path: "/subscriptions/{subscriptionId}/providers/Microsoft.Devices/checkProvisioningServiceNameAvailability"
---

# Check if a provisioning service name is available.

`POST /subscriptions/{subscriptionId}/providers/Microsoft.Devices/checkProvisioningServiceNameAvailability`

Check if a provisioning service name is available. This will validate if the name is syntactically valid and if the name is usable

## Parameters

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

## Request body

- OperationInputs — Input values for operation results call.
  - `name` string, required — The name of the Provisioning Service to check.

## Response `200`

The request has succeeded.

- NameAvailabilityInfo — Description of name availability.
  - `nameAvailable` boolean — specifies if a name is available or not
  - `reason` 'Invalid' | 'AlreadyExists' — specifies the reason a name is unavailable
  - `message` string — message containing a detailed reason name is unavailable

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2017-08-21-preview) `8bf0dd5394f5` — 2 warning, 1 info
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
  - api tag `IotDpsResource` removed
- **2026-07-13** (2017-08-21-preview) `05664c3823a3` — 2 info
  - api tag `IotDpsResource` added
  - api tag `POST` removed
- **2026-07-13** (2017-08-21-preview) `c3313282ab03` — 1 info
  - api operation id `IotDpsResource_CheckProvisioningServiceNameAvailability` removed and replaced with `IotDpsResource_CheckNameAvailability`
- **2026-07-13** (2017-08-21-preview) `16850e9ddcc3` — 1 info
  - api operation id `IotDpsResource_CheckNameAvailability` removed and replaced with `IotDpsResource_CheckProvisioningServiceNameAvailability`

[Change history](https://skmtc.dev/azure/apis/deviceprovisioningservices-microsoft-devices-deviceprovision/changes/subscriptions/:subscriptionId/providers/Microsoft.Devices/checkProvisioningServiceNameAvailability/post.md)

---

[API](https://skmtc.dev/azure/apis/deviceprovisioningservices-microsoft-devices-deviceprovision.md) · [All operations](https://skmtc.dev/azure/apis/deviceprovisioningservices-microsoft-devices-deviceprovision/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/deviceprovisioningservices-microsoft-devices-deviceprovision/revisions/42d943f380d1/schema)