APIs & SDKs/shadw REST API/Scan existing DNS

Scan existing DNS

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

Detect a domain's CURRENT public DNS records (via DNS-over-HTTPS) so they can be migrated into the console with one click. Records are returned, not added.

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}/scan', {
  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",
  "records": [
    { "name": "", "type": "A", "value": "76.76.21.21", "ttl": 300, "priority": null }
  ]
}