{"openapi":"3.1.0","info":{"title":"DNS Lookup API","version":"1.0.0","description":"Resolve DNS records — A, AAAA, MX, NS, TXT, CNAME, SOA, SRV, CAA, PTR — for any domain, fetch all common records in a single call, or run a reverse PTR lookup for an IPv4 address. Backed by Google DNS-over-HTTPS. Ideal for devops tooling, uptime and email-deliverability checks (SPF/DKIM/DMARC), security research and domain monitoring.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/dns-api","description":"oanor gateway"}],"tags":[{"name":"DNS"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/lookup":{"get":{"operationId":"get_v1_lookup","tags":["DNS"],"summary":"Records of one type","description":"","parameters":[{"name":"domain","in":"query","required":true,"description":"Domain name","schema":{"type":"string"},"example":"example.com"},{"name":"type","in":"query","required":false,"description":"A AAAA MX NS TXT CNAME SOA SRV CAA PTR","schema":{"type":"string"},"example":"A"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"A","domain":"example.com","status":"NOERROR","answers":[{"ttl":252,"data":"172.66.147.243","name":"example.com","type":"A"},{"ttl":252,"data":"104.20.23.154","name":"example.com","type":"A"}],"records":[{"ttl":252,"data":"172.66.147.243","name":"example.com","type":"A"},{"ttl":252,"data":"104.20.23.154","name":"example.com","type":"A"}],"authoritative":true},"meta":{"timestamp":"2026-05-30T04:09:46.681Z","request_id":"ec5d38c8-f100-4383-8113-36a45cd978bf"},"status":"ok","message":"DNS lookup completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/records":{"get":{"operationId":"get_v1_records","tags":["DNS"],"summary":"All common records","description":"","parameters":[{"name":"domain","in":"query","required":true,"description":"Domain name","schema":{"type":"string"},"example":"example.com"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"domain":"example.com","records":{"A":[{"ttl":251,"data":"104.20.23.154","name":"example.com","type":"A"},{"ttl":251,"data":"172.66.147.243","name":"example.com","type":"A"}],"MX":[{"ttl":225,"data":"0 .","name":"example.com","type":"MX"}],"NS":[{"ttl":21600,"data":"hera.ns.cloudflare.com.","name":"example.com","type":"NS"},{"ttl":21600,"data":"elliott.ns.cloudflare.com.","name":"example.com","type":"NS"}],"TXT":[{"ttl":300,"data":"_k2n1y4vw3qtb4skdx9e7dxt97qrmmq9","name":"example.com","type":"TXT"},{"ttl":300,"data":"v=spf1 -all","name":"example.com","type":"TXT"}],"AAAA":[{"ttl":300,"data":"2606:4700:10::6814:179a","name":"example.com","type":"AAAA"},{"ttl":300,"data":"2606:4700:10::ac42:93f3","name":"example.com","type":"AAAA"}],"CNAME":[]}},"meta":{"timestamp":"2026-05-30T04:09:47.775Z","request_id":"c3937092-3b73-4e13-8a12-696c247861b8"},"status":"ok","message":"DNS records retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/reverse":{"get":{"operationId":"get_v1_reverse","tags":["DNS"],"summary":"Reverse PTR for an IPv4","description":"","parameters":[{"name":"ip","in":"query","required":true,"description":"IPv4 address","schema":{"type":"string"},"example":"8.8.8.8"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"ip":"8.8.8.8","status":"NOERROR","hostnames":["dns.google"]},"meta":{"timestamp":"2026-05-30T04:09:48.119Z","request_id":"0b6bcf09-759b-4618-8a7e-d7ac5ed317b0"},"status":"ok","message":"Reverse DNS completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1200,"monthly_call_quota":120000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3400,"monthly_call_quota":600000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8900,"monthly_call_quota":2500000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/dns-api"}