shadwshadw/Docs
GuidesAPIGetting Started
Dashboard
shadw REST APIOverviewErrors
  • GETList domains
  • POSTAttach a domain to a project
  • GETGet a domain
  • PUTSet nameservers
  • POSTRenew the SSL certificate
APIs & SDKs/shadw REST API/Get a domain

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 short-lived JWT minted with POST /v1/token. 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": "acme.com",
  "nameservers": ["ns1.shadw.cloud", "ns2.shadw.cloud"],
  "auto_renew": true,
  "records": [
    { "id": "rec_a1", "type": "A", "name": "@", "value": "76.76.21.21", "ttl": 3600 }
  ]
}