arrow_back All endpoints

DNS Lookup

POST/api/v1/tools/dns-lookup1 credit per calldnsdomainnetworkmxnameserver

Queries public DNS for a hostname and returns every record of the requested type. Use it to verify a domain's mail routing before sending, confirm a DNS change has propagated, or find which nameservers a domain is on.

receipt_long
Why 1 credit?

One DNS query, answered in milliseconds and served from cache when the record is still fresh. This is the cheapest class of call on the platform.

Any HTTP client works. Replace the key with one from your dashboard.

bash
curl -X POST https://toolkitbackend-j69m.onrender.com/api/v1/tools/dns-lookup \
  -H "Authorization: Bearer tb_live_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "hostname": "example.com",
  "recordType": "MX"
}'

Input

FieldTypeRequiredDefaultDescription
hostnamestringrequired- Domain to resolve, without a scheme. Example: example.com
recordTypestringoptionalA DNS record type to query. Defaults to A. One of: A, AAAA, MX, TXT, NS, CNAME, SOA

Output

FieldTypeDescription
hostnamestringThe hostname that was queried.
recordTypestringThe record type that was queried.
recordsarrayMatching records. Shape depends on the record type.
foundbooleanFalse when the hostname resolves but holds no record of this type.

Try it

Sends a real POST /api/v1/tools/dns-lookup from your browser and charges 1 credit to your account.

Sign in to run this endpoint. New accounts start with free credits.