Listar domínios da conta

curl

curl https://app.cubehosting.com.br/api/domains \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/domains`, { headers });
const { domains } = await res.json();
for (const d of domains) console.log(d.hostname, d.status, d.project.name);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(f"{API}/domains", headers=headers, timeout=30)
r.raise_for_status()
for d in r.json()["domains"]:
    print(d["hostname"], d["status"], d["project"]["name"])

{
  "domains": [
    {
      "id": "01JA9K3M5P7R9T1V3X5Z7B9D1F",
      "projectId": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
      "hostname": "loja.com.br",
      "redirectTo": null,
      "status": "active",
      "error": null,
      "records": [
        {
          "type": "CNAME",
          "name": "loja.com.br",
          "value": "domains.cubehost.dev",
          "isOk": true
        },
        {
          "type": "TXT",
          "name": "_cube-verify.loja.com.br",
          "value": "cube-verify=4a4163549b3f77ae5fbfff6fa7480999",
          "isOk": true
        }
      ],
      "verifiedAt": "2026-09-28T15:11:01.597Z",
      "checkedAt": "2026-09-28T15:21:02.114Z",
      "createdAt": "2026-09-28T15:09:40.000Z",
      "project": {
        "id": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
        "name": "Loja"
      }
    },
    {
      "id": "01JA9K3M5P7R9T1V3X5Z7B9D1G",
      "projectId": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
      "hostname": "www.loja.com.br",
      "redirectTo": "loja.com.br",
      "status": "pending",
      "error": null,
      "records": [
        {
          "type": "CNAME",
          "name": "www.loja.com.br",
          "value": "domains.cubehost.dev",
          "isOk": false
        },
        {
          "type": "TXT",
          "name": "_cube-verify.loja.com.br",
          "value": "cube-verify=4a4163549b3f77ae5fbfff6fa7480999",
          "isOk": true
        }
      ],
      "verifiedAt": "2026-09-28T15:11:01.597Z",
      "checkedAt": "2026-09-28T15:21:02.114Z",
      "createdAt": "2026-09-28T15:09:40.000Z",
      "project": {
        "id": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
        "name": "Loja"
      }
    }
  ],
  "used": 2,
  "limit": 10,
  "target": "domains.cubehost.dev",
  "isAvailable": true
}

GET

domains

curl

curl https://app.cubehosting.com.br/api/domains \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/domains`, { headers });
const { domains } = await res.json();
for (const d of domains) console.log(d.hostname, d.status, d.project.name);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(f"{API}/domains", headers=headers, timeout=30)
r.raise_for_status()
for d in r.json()["domains"]:
    print(d["hostname"], d["status"], d["project"]["name"])

{
  "domains": [
    {
      "id": "01JA9K3M5P7R9T1V3X5Z7B9D1F",
      "projectId": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
      "hostname": "loja.com.br",
      "redirectTo": null,
      "status": "active",
      "error": null,
      "records": [
        {
          "type": "CNAME",
          "name": "loja.com.br",
          "value": "domains.cubehost.dev",
          "isOk": true
        },
        {
          "type": "TXT",
          "name": "_cube-verify.loja.com.br",
          "value": "cube-verify=4a4163549b3f77ae5fbfff6fa7480999",
          "isOk": true
        }
      ],
      "verifiedAt": "2026-09-28T15:11:01.597Z",
      "checkedAt": "2026-09-28T15:21:02.114Z",
      "createdAt": "2026-09-28T15:09:40.000Z",
      "project": {
        "id": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
        "name": "Loja"
      }
    },
    {
      "id": "01JA9K3M5P7R9T1V3X5Z7B9D1G",
      "projectId": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
      "hostname": "www.loja.com.br",
      "redirectTo": "loja.com.br",
      "status": "pending",
      "error": null,
      "records": [
        {
          "type": "CNAME",
          "name": "www.loja.com.br",
          "value": "domains.cubehost.dev",
          "isOk": false
        },
        {
          "type": "TXT",
          "name": "_cube-verify.loja.com.br",
          "value": "cube-verify=4a4163549b3f77ae5fbfff6fa7480999",
          "isOk": true
        }
      ],
      "verifiedAt": "2026-09-28T15:11:01.597Z",
      "checkedAt": "2026-09-28T15:21:02.114Z",
      "createdAt": "2026-09-28T15:09:40.000Z",
      "project": {
        "id": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
        "name": "Loja"
      }
    }
  ],
  "used": 2,
  "limit": 10,
  "target": "domains.cubehost.dev",
  "isAvailable": true
}

Cada domínio vem com o site que ele abre (project), o status e, em records, os dois registros para criar no DNS dele. used e limit são da conta inteira: o www conta como um domínio. Com isAvailable: false, o domínio próprio ainda não está liberado para a conta. Guia em Endereço e domínios.

Erros comuns

Código	HTTP	O que fazer
`invalid_api_key`	401	Confira o cabeçalho `Authorization: Bearer <chave>`.
`rate_limit_exceeded`	429	Espere os segundos do `Retry-After`.

Todos os códigos, com o formato do erro, em Códigos de erro.

Autorizações

Authorization

string

header

obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_….

Resposta

Os domínios da conta.

domains

object[]

obrigatório

Show child attributes

used

integer

obrigatório

Quantos domínios a conta tem, somando os sites.

limit

integer

obrigatório

O limite do plano: 0 abaixo do Tower; Tower 10, Fortress 20, Monolith 40.

target

string

obrigatório

O alvo do CNAME (domains.cubehost.dev).

isAvailable

boolean

obrigatório

false enquanto o domínio próprio ainda não está liberado para a conta (em breve).

Visão geral

Projetos

Templates

Controle

Logs e métricas

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Blob

Domínios

Avisos

Conta

Listar domínios da conta

Erros comuns

Autorizações

Resposta

​Erros comuns

Autorizações

Resposta

Erros comuns