Docs menu

Migration checker

Before you switch DNS providers, compare the new nameservers with the current ones, record by record.

POST /v1/migration

Price
Costs 5 credits, reserved when the job starts and charged when it finishes. Failed runs are free.
Cache
Answers are cached for up to 1 minute; send fresh=true to ask the source again.
MCP tool
check_migration

Run it in the browser

Request body

Request body fields
NameTypeDescription
domain (required)stringThe zone you are moving, such as example.com.
new_nameservers (required)array of stringThe new provider's nameservers, one per line.
namesarray of string or nullExtra names to compare, such as www or mail, one per line.
freshbooleanSkip the cache and ask the source again; costs the same.

Response

Response fields
NameTypeDescription
job_id (required)stringThe job's ID; poll GET /v1/jobs/{id}
tool (required)string
target (required)string
status (required)"ok" | "partial" | "error"
fetched_atstring
cachedboolean
credits_usedintegerCredits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in
summary (required)string
scoreinteger or null
findingsarray of object
credits_remaining (required)integerYour balance after this call. It can be below zero after a refund; free tools still work then
data (required)objectThis tool's result
data.domain (required)string
data.zone (required)string
data.ready (required)boolean
data.already_switched (required)boolean
data.parent_ns (required)array of string
data.parent_ns_ttlinteger or null
data.current_serverobject or null
data.new_servers (required)array of object
data.new_servers.name (required)string
data.new_servers.addressstring or null
data.new_servers.status (required)"ok" | "not_authoritative" | "unreachable" | "no_address"
data.new_servers.serialinteger or null
data.rows (required)array of object
data.rows.name (required)string
data.rows.type (required)string
data.rows.result (required)"same" | "missing" | "different" | "extra" | "ttl_differs" | "unknown"
data.rows.current (required)object
data.rows.new (required)array of object
data.checked_names (required)integer
data.names_from (required)object
data.dnssec (required)object
data.dnssec.parent_ds (required)boolean or nullThe parent publishes a DS record; null when its DS couldn't be read
data.dnssec.new_signingboolean or null
data.dnssec.ds_matches_newboolean or null
data.max_record_ttlinteger or null
data.min_ttlinteger or null

Errors

  • 400 Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`)
  • 401 Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)
  • 402 Balance below the call's price (`insufficient_credits`)
  • 403 Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`)
  • 429 Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged
  • 500 Unexpected error (`internal_error`)

Example

curl

curl
curl -X POST "https://api.dnssuper.com/v1/migration" \
  -H "Authorization: Bearer $DNSSUPER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'

Python

Python (httpx)
import os

import httpx

client = httpx.Client(
    base_url="https://api.dnssuper.com",
    headers={"Authorization": f"Bearer {os.environ['DNSSUPER_API_KEY']}"},
    timeout=60,
)
response = client.post("/v1/migration", json={
    "domain": "example.com",
})
response.raise_for_status()
result = response.json()
print(result["summary"], result["credits_used"])

TypeScript

TypeScript (fetch)
const response = await fetch("https://api.dnssuper.com/v1/migration", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"domain":"example.com"}),
});
if (!response.ok) throw new Error((await response.json()).error.message);
const result = await response.json();
console.log(result.summary, result.credits_used);
Example response
Example response
{
  "job_id": "5ef1741e-8198-585b-8440-2b6634de62c9",
  "status": "queued",
  "total": 1,
  "credits_reserved": 5,
  "duplicates_removed": 0,
  "job_url": "https://api.dnssuper.localhost/v1/jobs/5ef1741e-8198-585b-8440-2b6634de62c9",
  "items_url": "https://api.dnssuper.localhost/v1/jobs/5ef1741e-8198-585b-8440-2b6634de62c9/items",
  "events_url": "https://api.dnssuper.localhost/v1/jobs/5ef1741e-8198-585b-8440-2b6634de62c9/events"
}

MCP

MCP tool call
{
  "tool": "check_migration",
  "arguments": {
    "domain": "example.com"
  }
}
Compact MCP output
example.com is ready to move: the new nameservers answer the same way for all 81 names we compared.
Ready: yes
Current: ns1.old-dns.example.net (192.0.2.1), serial 2026111401
New: ns1.new-dns.example.net (198.51.100.1) (ok, serial 2026111401); ns2.new-dns.example.net (198.51.100.2) (ok, serial 2026111401)
Compared: 81 names, 12 records: 12 same
- info: We checked 81 names; DNS can't list the rest
- info: Lower your TTLs before you switch
1 check passed
Credits: 5 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC