DNS resolution

Resolve a domain from idcd's globally distributed nodes and compare the answers across regions — useful for spotting DNS poisoning, hijacking or propagation lag.

The DNS probe returns the common record types in one shot. Like all probes it is asynchronous: POST returns one task ID per node, then you poll the task.

Endpoint

POST

/v1/probe/dns

Base URL — https://api-prod.idcd.com/v1
Auth — Authorization: Bearer sk_live_...

Request body

{
  "target": "example.com",
  "node_ids": ["node_a", "node_b"]  // optional
}

Parameter	Type	Required	Default	Description
`target`	string	required	—	Domain to resolve.
`node_ids`	string[]	optional	—	Probe from these node IDs (max 20). Auto-selected when omitted.

No record_type parameter on the probe

The DNS probe resolves A first, then best-effort MX / TXT / CNAME / NS, and returns them all — there is no record_type option. For a single typed lookup from the API server (not multi-node), use GET /v1/info/dns?q=<domain>&type=<A|AAAA|MX|TXT|CNAME|NS|…>.

Response

POST returns the queued task IDs (HTTP 200); poll GET /v1/probe/tasks/{task_id} for each. The completed task's result carries:

GET

/v1/probe/tasks/{task_id}

Field	Type	Description
`result.success`	boolean	True when the A lookup resolved.
`result.records.A`	string[]	Resolved A records.
`result.records.MX / TXT / CNAME / NS`	various	Best-effort additional records (present when available).
`result.resolve_ms`	number	Resolution time in milliseconds.
`result.nameserver`	string	Upstream resolver used by the node.
`result.error`	string	Failure reason when the lookup failed.

Example

curl -s -X POST https://api-prod.idcd.com/v1/probe/dns \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com"}'
# => {"data":{"task_id":"tsk_789","task_ids":["tsk_789"],"status":"queued"}}

curl -s https://api-prod.idcd.com/v1/probe/tasks/tsk_789 \
  -H "Authorization: Bearer sk_live_xxx"
# => {"data":{"status":"completed","result":{"success":true,"records":{"A":["93.184.216.34"]}}}}

Limits

Rate limits & bounds

30 probe creations/min per IP, 300 task polls/min per IP, max 20 nodes per probe.

DNS online tool

Resolve from global nodes and compare answers — no API key required.