# Check availability of one or more specific domains (https://developer.godaddy.com/en/docs/references/rest/domains/v3/check-availability)

---
title: Check availability of one or more specific domains
description: Batch availability check for 1-25 domains.
full: true
---

Full description

Batch availability check for 1-25 domains. Returns one availability result per domain in input order. Domains that cannot be checked carry an error object on that item; the overall request still returns 200. Results are indicative; the authoritative check runs at quote time.

## POST /check-availability

Check availability of one or more specific domains

Batch availability check for 1-25 domains. Returns one availability result per domain in input order. Domains that cannot be checked carry an error object on that item; the overall request still returns 200. Results are indicative; the authoritative check runs at quote time.

### 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. |

### Request body (required)

Content-Type: `application/json`

```json
{
  "domains": [
    "example.com",
    "example.net"
  ]
}
```

Schema:

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

### Responses

**200** — Per-domain availability results in request order. Uncheckable items carry an error object.

Content-Type: `application/json`

```json
{
  "items": [
    {
      "domain": "example.com",
      "available": true,
      "definitive": false,
      "inventory": "REGISTRY",
      "prices": [
        {
          "term": "YEAR",
          "period": 1,
          "price": {
            "currencyCode": "USD",
            "value": 1999
          },
          "renewalPrice": {
            "currencyCode": "USD",
            "value": 1999
          }
        },
        {
          "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
        }
      ]
    },
    {
      "domain": "invalid..com",
      "error": {
        "name": "MISMATCH_FORMAT",
        "correlationId": "9f1c2e7a-4b3d-4e8f-a1c2-3d4e5f6a7b8c",
        "message": "does not conform to the 'domain' format, based on pattern: /^[^.\\s]{1,63}(\\.[^.\\s]{1,63}){1,2}$/"
      }
    }
  ]
}
```

Schema:

- object
  - `items` (required): array — Availability results in the same order as the domains array in the request body.
      - items:

**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`.