ShowMyIP REST API v1 - Developer Reference

Returns geolocation and network details for the given IPv4 or IPv6 address.

Path parameter

Parameter	Type	Description
ip	string	A valid IPv4 or IPv6 address. Must pass format validation; returns 400 otherwise.

Example request

curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.showmyip.com/api/v1/ip/8.8.8.8"

Example response

{
  "success": true,
  "data": {
    "ip": "8.8.8.8",
    "version": "IPv4",
    "reverse_dns": "dns.google",
    "geo": {
      "continent": "North America",
      "country": "United States",
      "country_code": "US",
      "region": "Virginia",
      "city": "Ashburn",
      "zip": "20149",
      "latitude": 39.03,
      "longitude": -77.5,
      "timezone": "America/New_York"
    },
    "network": {
      "isp": "Google LLC",
      "org": "Google Public DNS",
      "asn": "AS15169 Google LLC",
      "as_name": "GOOGLE"
    },
    "privacy": {
      "proxy": false,
      "vpn": false,
      "tor": false,
      "hosting": true,
      "mobile": false
    }
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-05-31T12:00:00+00:00"
  }
}

Performs a DNS lookup for the specified domain and record type.

Path parameter

Parameter	Type	Description
domain	string	A fully-qualified domain name (e.g. example.com). Validated server-side.

Query parameter

Parameter	Type	Default	Description
type	string	A	DNS record type. Accepted values: A, AAAA, MX, NS, TXT, SOA, CNAME, CAA, SRV.

Example request

curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.showmyip.com/api/v1/dns/example.com?type=MX"

Example response

{
  "success": true,
  "data": {
    "domain": "example.com",
    "type": "MX",
    "records": [
      { "name": "example.com", "ttl": 3600, "type": "MX", "value": "10 mail.example.com." }
    ],
    "raw": [
      "example.com.\t3600\tIN\tMX\t10 mail.example.com."
    ]
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-05-31T12:00:00+00:00"
  }
}

Each parsed record carries name, ttl (seconds), type, and value (the right-hand side of the answer line, verbatim). The raw array preserves the resolver’s unparsed answer lines for transparency.

Returns registration and routing details for the given Autonomous System Number.

Path parameter

Parameter	Type	Description
n	integer	A positive integer ASN (e.g. 15169). An optional AS prefix is accepted and stripped.

Example request

curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.showmyip.com/api/v1/asn/15169"

Example response

{
  "success": true,
  "data": {
    "asn": 15169,
    "asn_label": "AS15169",
    "organization": "Google LLC",
    "country": "US"
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-05-31T12:00:00+00:00"
  }
}

organization and country are parsed from the registry’s WHOIS response and may be null when the registry does not publish them.

Runs a composite email-deliverability scorecard for the domain, checking MX records, SPF, DKIM (common selectors), DMARC policy, and DNS-based blocklist (RBL) status. Uses the EmailHealthChecker backend which performs all lookups via PHP’s DNS resolver - no user input is shelled out.

Path parameter

Parameter	Type	Description
domain	string	The domain whose email configuration should be evaluated (e.g. example.com).

Example request

curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.showmyip.com/api/v1/email-health/example.com"

Example response

{
  "success": true,
  "data": {
    "domain": "example.com",
    "checked_at": "2026-05-31 12:00:00 UTC",
    "overall_score": 83,
    "grade": "B",
    "summary": "Score 83/100 - needs attention: DKIM, DMARC.",
    "checks": {
      "mx":        { "label": "MX Records", "status": "pass", "score": 100, "finding": "2 MX records published.", "details": [ "priority 10 -> mail.example.com" ], "fix": null },
      "spf":       { "label": "SPF", "status": "warn", "score": 80, "finding": "SPF uses soft fail (~all). Unauthorised mail is accepted but marked.", "details": [ "Record: v=spf1 include:_spf.example.com ~all" ], "fix": "Tighten \"~all\" to \"-all\" once every legitimate sender is listed." },
      "dkim":      { "label": "DKIM", "status": "warn", "score": 30, "finding": "No DKIM key found under common selectors. (DKIM selectors cannot be enumerated from DNS.)", "details": [ "Probed selectors: google, selector1, ..." ], "fix": "Enable DKIM signing and publish the public key under ._domainkey.example.com." },
      "dmarc":     { "label": "DMARC", "status": "warn", "score": 80, "finding": "DMARC at p=quarantine - failing mail is junked, not rejected.", "details": [ "Record: v=DMARC1; p=quarantine; rua=mailto:[email protected]" ], "fix": "Move to p=reject for full protection once quarantine runs cleanly." },
      "blacklist": { "label": "Blacklist (Primary MX IP)", "status": "pass", "score": 100, "finding": "Primary MX IP is clean on the blocklists checked.", "details": [ "Tested IP: 93.184.216.34 (primary MX mail.example.com)." ], "fix": null }
    }
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-05-31T12:00:00+00:00"
  }
}

Each check carries label, status (pass, warn, fail, or info), a score (0–100 for that individual check), a finding, a details array, and a fix (a remediation string, or null when the check passes). The five checks are mx, spf, dkim, dmarc, and blacklist. The top-level overall_score is a weighted roll-up of the individual check scores.

Checks whether the given IP address appears on DNS-based blocklists (DNSBLs/RBLs). The set of lists checked is determined server-side.

Path parameter

Parameter	Type	Description
ip	string	A valid IPv4 address. Must pass format validation; returns 400 otherwise.

Example request

curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.showmyip.com/api/v1/blacklist/8.8.8.8"

Example response

{
  "success": true,
  "data": {
    "ip": "8.8.8.8",
    "listed": false,
    "listed_count": 0,
    "checked_count": 6,
    "lists_checked": [ "Spamhaus ZEN", "SpamCop", "Barracuda", "UCEPROTECT L1" ],
    "could_not_check": [],
    "could_not_check_count": 0,
    "grade": "A+",
    "score": 100,
    "verdict": "clean",
    "listings": []
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2026-05-31T12:00:00+00:00",
    "cached": false
  }
}

Field	Type	Description
listed	bool	true when the IP is listed on at least one blocklist (i.e. verdict is "listed").
listed_count	int	Number of blocklists that returned a listing.
checked_count	int	Number of lists that returned a definitive verdict (listed or clean).
lists_checked	array<string>	Human-readable names of the lists that gave a definitive verdict.
could_not_check	array<string>	Names of lists that refused, timed out, or returned an error band this run (excluded from the grade).
could_not_check_count	int	Count of lists in could_not_check.
grade	string	Weighted reputation grade: A+ through F, or N/A when nothing could be checked.
score	int	Reputation score, 0–100.
verdict	string	One of clean, listed, or unknown.
listings	array<object>	One entry per list that returned a listing, each with zone, name, codes (the A-records returned), and delist (the official delisting URL, or null).

The meta.cached flag indicates whether this report was served from the per-target cache (the blacklist endpoint is the only route that adds cached to meta).