---
title: "Determine whether or not the specified domain is available for purchase"
method: GET
path: "/v1/domains/available"
tags: ["v1"]
---

# Determine whether or not the specified domain is available for purchase

`GET /v1/domains/available`

## Query parameters

- `domain` string, required
- `checkType` 'FAST' | 'FULL' | 'fast' | 'full'
- `forTransfer` boolean

## Response `200`

Request was successful

- DomainAvailableResponse
  - `available` boolean, required — Whether or not the domain name is available
  - `currency` string, iso-currency-code — Currency in which the `price` is listed. Only returned if tld is offered
  - `definitive` boolean, required — Whether or not the `available` answer has been definitively verified with the registry
  - `domain` string, required — Domain name
  - `period` integer — Number of years included in the price. Only returned if tld is offered
  - `price` integer — Price of the domain excluding taxes or fees. Only returned if tld is offered
  - `renewalPrice` integer — Price for renewing the domain excluding taxes or fees. Only returned if tld is offered

## Other responses

- `400` — Request was malformed
- `401` — Authentication info not sent or invalid
- `403` — Authenticated user is not allowed access
- `422` — Cannot convert domain label error<br>Domain is missing IDN script<br>Domain segment ends with dash<br>Domain starts with dashbr>Domain uses unsupported IDN script<br>FQDN fails generic validity regex<br>Invalid character(s) error<br>Invalid tld error<br>Non-IDN domain name must not have dashes at the third and fourth position<br>Reserved name error<br>domain must be specified
- `429` — Too many requests received within interval
- `500` — Internal server error

---

[API](https://skmtc.net/godaddy/apis/domains-api.md) · [All operations](https://skmtc.net/godaddy/apis/domains-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/godaddy/domains-api/versions/475bd0561c3c/schema)