{"openapi":"3.1.0","info":{"title":"HackMyIP Privacy API","description":"Free public REST API for IP geolocation, ISP / ASN detection, VPN / proxy / datacenter classification, email breach checking via the XposedOrNot database, and IP privacy / cleanliness scoring. Zero auth, no API key, no signup, no credit card. JSON responses, CORS-enabled, mobile-friendly.","version":"1.1.0","contact":{"name":"HackMyIP","url":"https://hackmyip.com"},"license":{"name":"Free for any use","url":"https://hackmyip.com"}},"servers":[{"url":"https://hackmyip.com","description":"Production"}],"paths":{"/api/ip":{"get":{"operationId":"getMyIp","summary":"Caller's IP address with geolocation, ISP, ASN, VPN detection, privacy score","description":"Returns the requesting client's public IP with full enrichment: geolocation (city, region, country, lat/lon, timezone), network details (ISP, ASN, organization, network type), VPN/proxy/datacenter classification, and privacy cleanliness grade A-D. No parameters, no auth.","tags":["IP"],"responses":{"200":{"description":"IP info with location, network, and privacy data","content":{"application/json":{"example":{"success":true,"data":{"ip":"1.2.3.4","location":{"city":"San Francisco","region":"California","country":"US","country_name":"United States","continent":"NA","latitude":"37.7749","longitude":"-122.4194","timezone":"America/Los_Angeles","postal_code":"94103"},"network":{"asn":13335,"isp":"Cloudflare, Inc.","connection_type":"HTTP/2","tls_version":"TLSv1.3"},"privacy":{"type":"residential","score":95,"grade":"A","is_vpn":false,"is_datacenter":false,"is_residential":true,"hosting":false,"proxy":false},"is_eu":false,"ipv6":false}}}}}}}},"/api/lookup":{"get":{"operationId":"lookupIp","summary":"Look up geolocation, ISP, and ASN for ANY IP address","description":"Resolve any IPv4 or IPv6 address to geolocation (city/region/country), ISP, ASN, organization, timezone. Powered by aggregated public IP databases. No auth.","tags":["IP"],"parameters":[{"name":"ip","in":"query","required":true,"schema":{"type":"string","example":"8.8.8.8"},"description":"IPv4 or IPv6 address to look up"}],"responses":{"200":{"description":"IP geolocation and network data","content":{"application/json":{"example":{"success":true,"data":{"ip":"8.8.8.8","location":{"city":"Ashburn","region":"Virginia","country":"US","country_name":"United States","latitude":39.03,"longitude":-77.5,"timezone":"America/New_York","postal_code":"20149"},"network":{"asn":15169,"isp":"Google LLC","org":"Google Public DNS"},"privacy":{"hosting":true,"proxy":false,"mobile":false}}}}}}}}},"/api/breach":{"get":{"operationId":"checkBreach","summary":"Check if an email has been exposed in known data breaches","description":"Checks the supplied email against the XposedOrNot breach database. Returns total breach count, affected services list, severity grade, password exposure summary, and recommended action. Useful for security audits, account recovery flows, and onboarding 'is your email pwned' checks. No auth required.","tags":["Privacy"],"parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","format":"email","example":"test@example.com"},"description":"Email address to check"}],"responses":{"200":{"description":"Breach data including count, services, risk level, and password exposure","content":{"application/json":{"example":{"success":true,"data":{"email":"tes***@example.com","status":"checked","breaches":3,"services":["LinkedIn","Adobe","MyFitnessPal"],"passwords":{"plain_text":1,"weak_hash":1,"strong_hash":1,"unknown":0,"total":3},"risk":{"score":65,"level":"high"}}}}}}}}},"/api/score":{"get":{"operationId":"getPrivacyScore","summary":"Get IP privacy cleanliness grade with VPN / proxy / datacenter classification","description":"Returns the caller's IP privacy grade (A-D), numeric cleanliness score (0-100), boolean classification (VPN/proxy/datacenter/residential), and risk flags (TOR exit, spam blacklist, mobile network). Useful for fraud scoring, abuse detection, and giving users a clear 'is your IP clean' answer. No auth.","tags":["Privacy"],"responses":{"200":{"description":"Privacy score with grade, type, and flags","content":{"application/json":{"example":{"success":true,"data":{"ip":"1.2.3.4","location":{"city":"San Francisco","country":"US","timezone":"America/Los_Angeles"},"network":{"isp":"Cloudflare, Inc.","asn":13335,"tls_version":"TLSv1.3"},"privacy":{"type":"residential","score":87,"grade":"B","label":"Clean","flags":["Residential ISP - no VPN detected"],"is_vpn":false,"is_datacenter":false,"is_residential":true},"ipv6":false}}}}}}}},"/api/dns":{"get":{"operationId":"dnsLookup","summary":"Look up DNS records for any domain (A, AAAA, MX, NS, TXT, CNAME, CAA, SOA)","description":"Resolves DNS records for a domain over public DNS. Defaults to A records; pass type for any record type. Returns parsed record values with TTL. Useful for DNS leak diagnostics, MX/SPF/DKIM/DMARC verification, propagation checks. No auth.","tags":["DNS"],"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","example":"github.com"},"description":"Domain name to query"},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["A","AAAA","MX","NS","TXT","CNAME","CAA","SOA"],"default":"A"},"description":"DNS record type"}],"responses":{"200":{"description":"DNS records with name, type, TTL, value","content":{"application/json":{"example":{"success":true,"data":{"domain":"github.com","type":"A","records":[{"name":"github.com","type":1,"TTL":60,"data":"140.82.112.3"}]}}}}}}}},"/api/whois":{"get":{"operationId":"whoisLookup","summary":"Look up WHOIS / RDAP registration data for a domain","description":"Returns domain registrar, creation date, expiration date, last updated date, name servers, and registration status. Powered by RDAP fallback to classic WHOIS. Useful for domain due diligence, expiry monitoring, abuse reporting. No auth.","tags":["DNS"],"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","example":"github.com"},"description":"Domain name to query"}],"responses":{"200":{"description":"Domain registration data","content":{"application/json":{"example":{"success":true,"data":{"domain":"GITHUB.COM","registrar":"MarkMonitor Inc.","creation_date":"2007-10-09T18:20:50Z","expiration_date":"2026-10-09T18:20:50Z","name_servers":["dns1.p08.nsone.net"],"status":["clientUpdateProhibited"]}}}}}}}},"/api/rdns":{"get":{"operationId":"reverseDns","summary":"Reverse DNS lookup: resolve IP to hostname (PTR record)","description":"Resolves an IP address to its PTR / reverse DNS hostname. Useful for mail server validation, network forensics, identifying servers behind an IP. No auth.","tags":["DNS"],"parameters":[{"name":"ip","in":"query","required":true,"schema":{"type":"string","example":"8.8.8.8"},"description":"IPv4 or IPv6 address"}],"responses":{"200":{"description":"Reverse DNS hostname","content":{"application/json":{"example":{"success":true,"data":{"ip":"8.8.8.8","hostname":"dns.google","ptr_record":"8.8.8.8.in-addr.arpa"}}}}}}}},"/api/blacklist":{"get":{"operationId":"checkBlacklist","summary":"Check an IP against major spam / abuse DNSBLs (Spamhaus, Barracuda, SpamCop, and 9 more)","description":"Queries 12 well-known DNSBL blocklists (Spamhaus ZEN, Barracuda, SpamCop, UCEPROTECT, etc.) and returns which ones list the IP plus an overall CLEAN/LISTED status. Useful for fraud scoring, mail server reputation checks, abuse triage. No auth.","tags":["Privacy"],"parameters":[{"name":"ip","in":"query","required":true,"schema":{"type":"string","example":"8.8.8.8"},"description":"IPv4 to check (IPv6 not supported by most DNSBLs)"}],"responses":{"200":{"description":"Blacklist status with per-list breakdown","content":{"application/json":{"example":{"success":true,"data":{"ip":"8.8.8.8","total_lists":12,"total_checked":10,"unavailable_count":2,"listed_count":0,"clean":true,"status":"CLEAN","results":[{"name":"Spamhaus ZEN","zone":"zen.spamhaus.org","listed":false}]}}}}}}}},"/api/down":{"get":{"operationId":"checkSite","summary":"Check whether a website is up or down with response time","description":"Fetches the supplied URL and returns up/down status plus response time in ms and HTTP status code. Useful for monitoring, uptime checks, 'is X down for everyone' diagnostics. No auth.","tags":["Network"],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","example":"example.com"},"description":"URL or hostname to check (protocol optional)"}],"responses":{"200":{"description":"Up / down status with response time and HTTP code","content":{"application/json":{"example":{"success":true,"data":{"url":"https://example.com","is_up":true,"status_code":200,"status_text":"OK","response_time_ms":142,"server":"cloudflare","content_type":"text/html","checked_at":"2026-08-15T00:00:00.000Z"}}}}}}}},"/api/bulk":{"post":{"operationId":"bulkLookup","summary":"Look up geolocation, ISP, ASN for up to 50 IPs in a single request","description":"Batch IP lookup. Accepts a JSON array of up to 50 IPs and returns an array of enriched records (geolocation, ISP, ASN). Faster than 50 sequential /api/lookup calls and rate-limit friendly. No auth.","tags":["IP"],"requestBody":{"required":true,"content":{"application/json":{"example":{"ips":["8.8.8.8","1.1.1.1","208.67.222.222"]}}}},"responses":{"200":{"description":"Array of enriched IP records","content":{"application/json":{"example":{"success":true,"data":{"total":2,"results":[{"ip":"8.8.8.8","country":"US","city":"Ashburn","isp":"Google LLC","org":"Google Public DNS","lat":39.03,"lon":-77.5},{"ip":"1.1.1.1","country":"AU","city":"South Brisbane","isp":"Cloudflare, Inc","org":"APNIC and Cloudflare DNS Resolver project","lat":-27.4766,"lon":153.0166}]}}}}}}}}},"tags":[{"name":"IP","description":"IP address lookup, geolocation, and batch operations"},{"name":"Privacy","description":"Privacy scoring, breach checking, blacklist reputation"},{"name":"DNS","description":"DNS resolution, WHOIS, and reverse DNS"},{"name":"Network","description":"Site reachability and network diagnostics"}],"externalDocs":{"description":"Full documentation and 50+ browser tools","url":"https://hackmyip.com"}}