---
title: "Check domain name availability"
method: GET
path: "/domains/{domainName}"
tags: ["domains"]
---

# Check domain name availability

`GET /domains/{domainName}`

## Request

- Base URL: `https://api.unstoppabledomains.com/registry/v1`
- URL: `https://api.unstoppabledomains.com/registry/v1/domains/{domainName}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/registry-api-v1/docs/domains/:domainName/get.ts> (a function with typed inputs; its response is checked against the schema)

Check domain name availability

## Response `200`

Successful

- DomainAvailabilityResponse
  - `domain` string: Domain name
  - `availability` Availability
    - `status` 'AVAILABLE' | 'DISALLOWED': Availability status
    - `price` DomainPriceResponse
      - `listPrice` DomainPriceItemResponse, required
        - `usdCents` number, required
      - `subTotal` DomainPriceItemResponse, required
        - `usdCents` number, required

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/unstoppabledomains/apis/registry-api-v1.md) - [All operations](https://skmtc.dev/unstoppabledomains/apis/registry-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/unstoppabledomains/apis/registry-api-v1/revisions/c9c9160c1781?raw)
