---
title: "Is a domain being registered for this account?"
method: GET
path: "/v1/provisioning"
tags: ["Provisioning"]
---

# Is a domain being registered for this account?

`GET /v1/provisioning`

## Request

- Base URL: `https://dnsmint.com/api`
- URL: `https://dnsmint.com/api/v1/provisioning`
- Auth: `apiKey` (a scheme the document does not define)

The other half of the 409 `DOMAIN_PROVISIONING` that `POST /v1/hostnames` returns while a domain is still being bought. That response says to retry shortly; this says when retrying will work, so a caller does not have to poll the write endpoint to find out. Reports only: reading it buys, claims and promotes nothing, so a polling loop cannot become a spending loop.

## Response `200`

The state of the newest domain bought for this account.

- ProvisioningStatus
  - `state` 'none' | 'provisioning' | 'ready' | 'claimed', required: `none`: nothing is being bought, so retrying will not help. `provisioning`: a domain is being set up for this team. `ready`: bought and delegated, waiting to be claimed. `claimed`: assigned to this account, so minting works.
  - `domain` string: The domain bought for this account, when there is one.
  - `since` string, date-time: When it was registered, so a caller can show how long it has been.
  - `delegated` boolean: Whether public DNS shows our nameservers yet.
  - `retry_after` integer, required: Seconds to wait before asking again. Zero when there is nothing to wait for.

## Other responses

- `401`: The Authorization header is missing, malformed, or the key is unknown or revoked.
- `403`: The key does not carry `hostnames:read`.

---

[API](https://skmtc.dev/dnsmint/apis/dnsmint-api.md) · [All operations](https://skmtc.dev/dnsmint/apis/dnsmint-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dnsmint/apis/dnsmint-api/revisions/98fb1f87725a?raw)