---
title: "Check whether a subdomain is currently available"
method: GET
path: "/sites/availability"
tags: ["Sites"]
---

# Check whether a subdomain is currently available

`GET /sites/availability`

## Request

- Base URL: `https://api.nippy.host`
- URL: `https://api.nippy.host/sites/availability`
- Auth: none declared

## Query parameters

- `subdomain` string, required

## Response `200`

Availability check result

- APIAvailabilityResponse
  - `available` boolean, required: True if the subdomain is free to claim
  - `reason` 'invalid_format' | 'too_short' | 'too_long' | 'reserved' | 'taken': Machine-readable reason when `available` is false

---

[API](https://skmtc.dev/nippy/apis/nippy-backend-api.md) · [All operations](https://skmtc.dev/nippy/apis/nippy-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nippy/apis/nippy-backend-api/revisions/7ab23f040a55?raw)