# Check availability of a single domain (https://developer.godaddy.com/en/docs/references/rest/domains/v3/get-domain-availability)

---
title: Check availability of a single domain
description: Returns an indicative availability and pricing result for a single domain.
full: true
---

Full description

Returns an indicative availability and pricing result for a single domain. Best-effort only; the authoritative check runs at quote time. Unavailable or uncheckable domains return 200 with an error object; request-level failures use 4xx.

## GET /check-availability

Check availability of a single domain

Returns an indicative availability and pricing result for a single domain. Best-effort only; the authoritative check runs at quote time. Unavailable or uncheckable domains return 200 with an error object; request-level failures use 4xx.

### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `domain` | string | yes | The domain name to check, in punycode A-label form for IDNs. |
| `optimizeFor` | allOf(unknown) | no | Optional. When omitted, defaults to SPEED. Availability is always re-verified authoritatively at quote time regardless of this setting. |
| `iscCode` | string | no | ISC (International Shopper Code) for pricing context. When provided, prices reflect the applicable rates for this ISC. |

### Header parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `X-Request-Id` | unknown | no | Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header. |

### Responses

**200** — Availability result for the requested domain.

Content-Type: `application/json`

```json
{
  "domain": "coffee24x7x365.com",
  "available": true,
  "definitive": false,
  "inventory": "REGISTRY",
  "prices": [
    {
      "term": "YEAR",
      "period": 1,
      "price": {
        "currencyCode": "USD",
        "value": 1199
      },
      "renewalPrice": {
        "currencyCode": "USD",
        "value": 2299
      }
    },
    {
      "term": "YEAR",
      "period": 2,
      "price": {
        "currencyCode": "USD",
        "value": 3098
      },
      "renewalPrice": {
        "currencyCode": "USD",
        "value": 4598
      },
      "firstTermPrice": {
        "currencyCode": "USD",
        "value": 799
      }
    },
    {
      "term": "YEAR",
      "period": 3,
      "price": {
        "currencyCode": "USD",
        "value": 4599
      },
      "renewalPrice": {
        "currencyCode": "USD",
        "value": 6897
      },
      "firstTermPrice": {
        "currencyCode": "USD",
        "value": 499
      },
      "recommended": true
    },
    {
      "term": "YEAR",
      "period": 5,
      "price": {
        "currencyCode": "USD",
        "value": 9197
      },
      "renewalPrice": {
        "currencyCode": "USD",
        "value": 11495
      },
      "firstTermPrice": {
        "currencyCode": "USD",
        "value": 100
      }
    }
  ]
}
```

Schema:

- schema reference: `#/components/schemas/Availability`

**400** — Malformed request syntax, missing required field, or invalid field type.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/21ae8c5`

**401** — Authentication credentials are missing or invalid.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/21ae8c5`

**403** — Authenticated identity is not authorized to perform this operation.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/21ae8c5`

**422** — Semantically invalid request — valid structure but violates a business rule, such as an ineligible contact, unsupported TLD, non-renewable domain status, or quote_mismatch (e.g. iscCode or acknowledgedFees that do not match the locked quote).

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/21ae8c5`

**429** — Too many requests — rate limit exceeded.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/21ae8c5`

**Security:** requires `bearerAuth`.