---
title: "Check if a subdomain is available"
method: POST
path: "/v1/hosting/websites/subdomain/check"
tags: ["Subdomain"]
---

# Check if a subdomain is available

`POST /v1/hosting/websites/subdomain/check`

## Request

- Base URL: `https://api.10web.io`
- URL: `https://api.10web.io/v1/hosting/websites/subdomain/check`
- Auth: none declared. Required headers: `x-api-key`
- TypeScript: <https://skmtc.dev/10web/apis/10web-api-v1/docs/v1/hosting/websites/subdomain/check/post.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `x-api-key` string, required

## Request body

- object
  - `subdomain` string, required: The subdomain to check for availability (max 63 chars)

## Response `200`

Subdomain availability check result

- object
  - `status` 'ok' | 'error'
  - `message` string: Status message about the subdomain

## Other responses

- `400`: Bad request
- `403`: Unauthorized access
- `429`: Too many requests
- `500`: Something went wrong

---

[API](https://skmtc.dev/10web/apis/10web-api-v1.md) - [All operations](https://skmtc.dev/10web/apis/10web-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/10web/apis/10web-api-v1/revisions/01afc9651dfc?raw)