curl https://api.phanomcloud.online/apps/check/my-cool-app
const res = await fetch("https://api.phanomcloud.online/apps/check/my-cool-app");
const { data } = await res.json();
if (data.available) {
console.log("Available at:", data.url);
} else {
console.log("Unavailable:", data.reason);
}
{
"success": true,
"data": {
"available": true,
"name": "my-cool-app",
"url": "https://my-cool-app.phanomcloud.online"
}
}
{
"success": true,
"data": {
"available": false,
"reason": "\"my-cool-app\" is already taken"
}
}
{
"success": true,
"data": {
"available": false,
"reason": "\"admin\" is a reserved name"
}
}
{
"success": true,
"data": {
"available": false,
"reason": "Only lowercase letters, numbers and hyphens. Cannot start or end with hyphen."
}
}
Apps
Check Subdomain
Checks if a subdomain name is available. Public endpoint — no authentication required.
GET
/
apps
/
check
/
{name}
curl https://api.phanomcloud.online/apps/check/my-cool-app
const res = await fetch("https://api.phanomcloud.online/apps/check/my-cool-app");
const { data } = await res.json();
if (data.available) {
console.log("Available at:", data.url);
} else {
console.log("Unavailable:", data.reason);
}
{
"success": true,
"data": {
"available": true,
"name": "my-cool-app",
"url": "https://my-cool-app.phanomcloud.online"
}
}
{
"success": true,
"data": {
"available": false,
"reason": "\"my-cool-app\" is already taken"
}
}
{
"success": true,
"data": {
"available": false,
"reason": "\"admin\" is a reserved name"
}
}
{
"success": true,
"data": {
"available": false,
"reason": "Only lowercase letters, numbers and hyphens. Cannot start or end with hyphen."
}
}
Path Parameters
string
required
The subdomain name to check. Lowercase letters, numbers and hyphens only.
Validation Rules
| Rule | Requirement |
|---|---|
| Length | Between 3 and 32 characters |
| Characters | Lowercase letters, numbers and hyphens (-) only |
| Start/End | Cannot start or end with a hyphen |
| Reserved names | Cannot use reserved names like api, www, admin, dashboard, etc. |
curl https://api.phanomcloud.online/apps/check/my-cool-app
const res = await fetch("https://api.phanomcloud.online/apps/check/my-cool-app");
const { data } = await res.json();
if (data.available) {
console.log("Available at:", data.url);
} else {
console.log("Unavailable:", data.reason);
}
{
"success": true,
"data": {
"available": true,
"name": "my-cool-app",
"url": "https://my-cool-app.phanomcloud.online"
}
}
{
"success": true,
"data": {
"available": false,
"reason": "\"my-cool-app\" is already taken"
}
}
{
"success": true,
"data": {
"available": false,
"reason": "\"admin\" is a reserved name"
}
}
{
"success": true,
"data": {
"available": false,
"reason": "Only lowercase letters, numbers and hyphens. Cannot start or end with hyphen."
}
}
⌘I

