Get a domain

GEThttps://api.shadw.cloud/v1/domains/{domain}

Get a domain with its DNS records, nameservers, SSL certificate and connected projects.

Authentication

AuthorizationbearerToken

A platform API key (hive_…, created under Settings → API Keys) or a JWT of at most 1 hour from POST /v1/token, which is server-only once HIVE_JWT_SECRET is set. An API key scopes the request to the team it was created under.

Path parameters

domainstringRequired

The domain name.

ts

const response = await fetch('https://api.shadw.cloud/v1/domains/{domain}', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY', // hive_… (Settings → API Keys)
  },
});

const data = await response.json();
console.log(data);

Response

json

{
  "domain": {
    "domain": "acme.com",
    "tenant": "acme",
    "registrar": "",
    "renewal_price": "",
    "auto_renew": false,
    "cdn_active": true,
    "created_ms": 1781906630000,
    "expires_ms": 0,
    "nameservers": ["ns1.shadw.cloud", "ns2.shadw.cloud"],
    "ssl": { "id": "", "cns": [], "renewal": "pending", "issued_ms": 0, "expires_ms": 0, "provider": "OpenEdge (Let's Encrypt)" },
    "records": [
      { "id": "rec_3f9c2db1e77a41b0", "name": "", "type": "CAA", "value": "0 issue \"letsencrypt.org\"", "ttl": 60, "priority": null, "comment": "Managed SSL issuer", "created_ms": 1781906630000, "system": true }
    ]
  },
  "connected": []
}

APIs & SDKs/shadw REST API/Get a domain