Docs menu

SSL check

Check a site's certificate, chain, expiry and TLS versions, for the domain and its www name.

GET /v1/ssl

Price
Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.
Cache
Answers are cached for up to 1 hour; send fresh=true to ask the source again.
MCP tool
check_ssl

Run it in the browser

Query parameters

Query parameters
NameTypeDescription
domain (required)stringA domain or URL; port 443 is always checked.
freshbooleanSkip the cache and ask the source again; costs the same.

Response

Response fields
NameTypeDescription
tool (required)string
target (required)string
status (required)"ok" | "partial" | "error"
fetched_atstring
cachedboolean
credits_usedintegerCredits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in
summary (required)string
scoreinteger or null
findingsarray of object
credits_remaining (required)integerYour balance after this call. It can be below zero after a refund; free tools still work then
data (required)objectThis tool's result
data.name (required)string
data.unicode (required)string
data.hosts (required)array of object
data.hosts.host (required)string
data.hosts.status (required)"ok" | "no_address" | "ipv6_only" | "refused" | "closed" | "not_tls" | "handshake_failed" | "timeout" | "dns_failed"
data.hosts.address (required)string or null
data.hosts.error (required)object or null
data.hosts.tls (required)object or null
data.hosts.certificate (required)object or null
data.hosts.chain (required)array of objectThe certificates as the server sent them.
data.hosts.trust (required)object or null
data.trust_store (required)object
data.trust_store.source (required)string
data.trust_store.version (required)string
data.legacy_versions_tested (required)booleanWhether TLS 1.0 and 1.1 were probed.
data.not_checkedstring or null

Errors

  • 400 Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`)
  • 401 Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)
  • 402 Balance below the call's price (`insufficient_credits`)
  • 403 Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`)
  • 429 Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged
  • 500 Unexpected error (`internal_error`)
  • 502 Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to

Example

curl

curl
curl "https://api.dnssuper.com/v1/ssl?domain=example.com" \
  -H "Authorization: Bearer $DNSSUPER_API_KEY"

Python

Python (httpx)
import os

import httpx

client = httpx.Client(
    base_url="https://api.dnssuper.com",
    headers={"Authorization": f"Bearer {os.environ['DNSSUPER_API_KEY']}"},
    timeout=60,
)
response = client.get("/v1/ssl", params={
    "domain": "example.com",
})
response.raise_for_status()
result = response.json()
print(result["summary"], result["credits_used"])

TypeScript

TypeScript (fetch)
const response = await fetch(`https://api.dnssuper.com/v1/ssl?${new URLSearchParams({"domain":"example.com"})}`, {
  headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}` },
});
if (!response.ok) throw new Error((await response.json()).error.message);
const result = await response.json();
console.log(result.summary, result.credits_used);
Example response
Example response
{
  "tool": "ssl-checker",
  "target": "example.com",
  "status": "ok",
  "fetched_at": "2026-11-14T10:00:00Z",
  "cached": false,
  "credits_used": 1,
  "summary": "example.com's certificate on port 443 is trusted and valid for 62 more days, covering example.com and www.example.com. The server offers TLS 1.3.",
  "score": 100,
  "findings": [],
  "data": {
    "name": "example.com",
    "unicode": "example.com",
    "hosts": [
      {
        "host": "example.com",
        "status": "ok",
        "address": "192.0.2.10",
        "tls": {
          "version": "TLSv1.3",
          "cipher": "TLS_AES_128_GCM_SHA256",
          "forward_secrecy": true,
          "alpn": "h2",
          "versions": {
            "TLSv1.3": true,
            "TLSv1.2": true,
            "TLSv1.1": false,
            "TLSv1.0": false
          },
          "non_forward_secret": false,
          "ocsp_stapled": false
        },
        "certificate": {
          "subject": "CN=example.com",
          "common_name": "example.com",
          "names": [
            "example.com",
            "www.example.com"
          ],
          "issuer": "CN=Example Issuing CA 1,O=Example Trust Services",
          "issuer_org": "Example Trust Services",
          "caa_identifiers": [],
          "serial": "DD50001",
          "not_before": "2026-10-15T10:00:00Z",
          "not_after": "2027-01-15T10:00:00Z",
          "days_left": 62,
          "key": {
            "type": "EC",
            "size": 256,
            "curve": "secp256r1"
          },
          "signature_algorithm": "ecdsa-with-SHA256",
          "sha256": "743c1c3c7fac8a213ec88acd9fbb53f54072675448f8b099de2458cbcafaff65",
          "scts": 2,
          "ca_issuers_url": "http://ca.example-ca.net/intermediate.der"
        },
        "chain": [
          {
            "subject": "CN=example.com",
            "issuer": "CN=Example Issuing CA 1,O=Example Trust Services",
            "not_after": "2027-01-15T10:00:00Z",
            "sha256": "743c1c3c7fac8a213ec88acd9fbb53f54072675448f8b099de2458cbcafaff65",
            "is_ca": false,
            "self_signed": false,
            "pem": "-----BEGIN CERTIFICATE-----\nMIICmTCCAj+gAwIBAgIEDdUAATAKBggqhkjOPQQDAjBAMR8wHQYDVQQKDBZFeGFt\ncGxlIFRydXN0IFNlcnZpY2VzMR0wGwYDVQQDDBRFeGFtcGxlIElzc3VpbmcgQ0Eg\nMTAeFw0yNjEwMTUxMDAwMDBaFw0yNzAxMTUxMDAwMDBaMBYxFDASBgNVBAMMC2V4\nYW1wbGUuY29tMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEfO7WksKIHG6uJqa3\n6So0HYq6vCa1u/fh/upQC/6LzF39dygCaZgg5EQ8LLZV2VvndDC+BEmXqIqzlcPG\nHjIIXqOCAU8wggFLMAwGA1UdEwEB/wQCMAAwDgYDVR0PAQH/BAQDAgeAMBMGA1Ud\nJQQMMAoGCCsGAQUFBwMBMB8GA1UdIwQYMBaAFNJrTleFVnmjKhl/60LXow/xyzy1\nMCcGA1UdEQQgMB6CC2V4YW1wbGUuY29tgg93d3cuZXhhbXBsZS5jb20wRQYIKwYB\nBQUHAQEEOTA3MDUGCCsGAQUFBzAChilodHRwOi8vY2EuZXhhbXBsZS1jYS5uZXQv\naW50ZXJtZWRpYXRlLmRlcjCBhAYKKwYBBAHWeQIEAgR2BHQAcgA3AAEBAQEBAQEB\nAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAAABodRZiQAAAAQDAAgwBgIBAQIBAQA3\nAAICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAAABodRZiQAAAAQDAAgw\nBgIBAQIBATAKBggqhkjOPQQDAgNIADBFAiEA3rxYH6BqT4aQJRMD+1rOdZIuBuo7\nAs6nwvtcVRvZ/xoCIFDCxiuv8a15Xg8ZsfrJ4Rk0vLjwqD6/zIduVr2n28F0\n-----END CERTIFICATE-----\n"
          },
          {
            "subject": "CN=Example Issuing CA 1,O=Example Trust Services",
            "issuer": "CN=Example Root R1,O=Example Trust Services",
            "not_after": "2029-11-13T10:00:00Z",
            "sha256": "3047b601d496c641600c9a9f5ba3681402c8fa77978696b93808d4e2a432c649",
            "is_ca": true,
            "self_signed": false,
            "pem": "-----BEGIN CERTIFICATE-----\nMIIBzzCCAXSgAwIBAgICcaEwCgYIKoZIzj0EAwIwOzEfMB0GA1UECgwWRXhhbXBs\nZSBUcnVzdCBTZXJ2aWNlczEYMBYGA1UEAwwPRXhhbXBsZSBSb290IFIxMB4XDTI1\nMTExNDEwMDAwMFoXDTI5MTExMzEwMDAwMFowQDEfMB0GA1UECgwWRXhhbXBsZSBU\ncnVzdCBTZXJ2aWNlczEdMBsGA1UEAwwURXhhbXBsZSBJc3N1aW5nIENBIDEwWTAT\nBgcqhkjOPQIBBggqhkjOPQMBBwNCAATZ5oN9WLrjjXlTCS166j1AFHd7X0xShWSj\nnIFOd0loaR2DeXT/T4o1/f+EpMVtdZgLnbPrWRrFadp9VxmLgv/Vo2MwYTAPBgNV\nHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQU0mtOV4VWeaMq\nGX/rQtejD/HLPLUwHwYDVR0jBBgwFoAUXzm0FsPAx8gBuBni0NVHsgUxjIowCgYI\nKoZIzj0EAwIDSQAwRgIhAMYiF0BFFTpgucp4JnrqGd/XURVGelUa34UbxM0uam7I\nAiEAtRCg/a3hsQYaaZ5yVVftVWSmCxvjEjCblqj7vDrfi2Q=\n-----END CERTIFICATE-----\n"
          }
        ],
        "trust": {
          "trusted": true,
          "hostname_match": true,
          "root": "CN=Example Root R1,O=Example Trust Services",
          "path": [
            "CN=example.com",
            "CN=Example Issuing CA 1,O=Example Trust Services",
            "CN=Example Root R1,O=Example Trust Services"
          ]
        }
      },
      {
        "host": "www.example.com",
        "status": "ok",
        "address": "192.0.2.11",
        "tls": {
          "version": "TLSv1.3",
          "cipher": "TLS_AES_128_GCM_SHA256",
          "forward_secrecy": true,
          "alpn": "h2",
          "versions": {
            "TLSv1.3": true,
            "TLSv1.2": true,
            "TLSv1.1": false,
            "TLSv1.0": false
          },
          "non_forward_secret": false,
          "ocsp_stapled": false
        },
        "certificate": {
          "subject": "CN=example.com",
          "common_name": "example.com",
          "names": [
            "example.com",
            "www.example.com"
          ],
          "issuer": "CN=Example Issuing CA 1,O=Example Trust Services",
          "issuer_org": "Example Trust Services",
          "caa_identifiers": [],
          "serial": "DD50001",
          "not_before": "2026-10-15T10:00:00Z",
          "not_after": "2027-01-15T10:00:00Z",
          "days_left": 62,
          "key": {
            "type": "EC",
            "size": 256,
            "curve": "secp256r1"
          },
          "signature_algorithm": "ecdsa-with-SHA256",
          "sha256": "743c1c3c7fac8a213ec88acd9fbb53f54072675448f8b099de2458cbcafaff65",
          "scts": 2,
          "ca_issuers_url": "http://ca.example-ca.net/intermediate.der"
        },
        "chain": [
          {
            "subject": "CN=example.com",
            "issuer": "CN=Example Issuing CA 1,O=Example Trust Services",
            "not_after": "2027-01-15T10:00:00Z",
            "sha256": "743c1c3c7fac8a213ec88acd9fbb53f54072675448f8b099de2458cbcafaff65",
            "is_ca": false,
            "self_signed": false,
            "pem": "-----BEGIN CERTIFICATE-----\nMIICmTCCAj+gAwIBAgIEDdUAATAKBggqhkjOPQQDAjBAMR8wHQYDVQQKDBZFeGFt\ncGxlIFRydXN0IFNlcnZpY2VzMR0wGwYDVQQDDBRFeGFtcGxlIElzc3VpbmcgQ0Eg\nMTAeFw0yNjEwMTUxMDAwMDBaFw0yNzAxMTUxMDAwMDBaMBYxFDASBgNVBAMMC2V4\nYW1wbGUuY29tMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEfO7WksKIHG6uJqa3\n6So0HYq6vCa1u/fh/upQC/6LzF39dygCaZgg5EQ8LLZV2VvndDC+BEmXqIqzlcPG\nHjIIXqOCAU8wggFLMAwGA1UdEwEB/wQCMAAwDgYDVR0PAQH/BAQDAgeAMBMGA1Ud\nJQQMMAoGCCsGAQUFBwMBMB8GA1UdIwQYMBaAFNJrTleFVnmjKhl/60LXow/xyzy1\nMCcGA1UdEQQgMB6CC2V4YW1wbGUuY29tgg93d3cuZXhhbXBsZS5jb20wRQYIKwYB\nBQUHAQEEOTA3MDUGCCsGAQUFBzAChilodHRwOi8vY2EuZXhhbXBsZS1jYS5uZXQv\naW50ZXJtZWRpYXRlLmRlcjCBhAYKKwYBBAHWeQIEAgR2BHQAcgA3AAEBAQEBAQEB\nAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAAABodRZiQAAAAQDAAgwBgIBAQIBAQA3\nAAICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAAABodRZiQAAAAQDAAgw\nBgIBAQIBATAKBggqhkjOPQQDAgNIADBFAiEA3rxYH6BqT4aQJRMD+1rOdZIuBuo7\nAs6nwvtcVRvZ/xoCIFDCxiuv8a15Xg8ZsfrJ4Rk0vLjwqD6/zIduVr2n28F0\n-----END CERTIFICATE-----\n"
          },
          {
            "subject": "CN=Example Issuing CA 1,O=Example Trust Services",
            "issuer": "CN=Example Root R1,O=Example Trust Services",
            "not_after": "2029-11-13T10:00:00Z",
            "sha256": "3047b601d496c641600c9a9f5ba3681402c8fa77978696b93808d4e2a432c649",
            "is_ca": true,
            "self_signed": false,
            "pem": "-----BEGIN CERTIFICATE-----\nMIIBzzCCAXSgAwIBAgICcaEwCgYIKoZIzj0EAwIwOzEfMB0GA1UECgwWRXhhbXBs\nZSBUcnVzdCBTZXJ2aWNlczEYMBYGA1UEAwwPRXhhbXBsZSBSb290IFIxMB4XDTI1\nMTExNDEwMDAwMFoXDTI5MTExMzEwMDAwMFowQDEfMB0GA1UECgwWRXhhbXBsZSBU\ncnVzdCBTZXJ2aWNlczEdMBsGA1UEAwwURXhhbXBsZSBJc3N1aW5nIENBIDEwWTAT\nBgcqhkjOPQIBBggqhkjOPQMBBwNCAATZ5oN9WLrjjXlTCS166j1AFHd7X0xShWSj\nnIFOd0loaR2DeXT/T4o1/f+EpMVtdZgLnbPrWRrFadp9VxmLgv/Vo2MwYTAPBgNV\nHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQU0mtOV4VWeaMq\nGX/rQtejD/HLPLUwHwYDVR0jBBgwFoAUXzm0FsPAx8gBuBni0NVHsgUxjIowCgYI\nKoZIzj0EAwIDSQAwRgIhAMYiF0BFFTpgucp4JnrqGd/XURVGelUa34UbxM0uam7I\nAiEAtRCg/a3hsQYaaZ5yVVftVWSmCxvjEjCblqj7vDrfi2Q=\n-----END CERTIFICATE-----\n"
          }
        ],
        "trust": {
          "trusted": true,
          "hostname_match": true,
          "root": "CN=Example Root R1,O=Example Trust Services",
          "path": [
            "CN=example.com",
            "CN=Example Issuing CA 1,O=Example Trust Services",
            "CN=Example Root R1,O=Example Trust Services"
          ]
        }
      }
    ],
    "trust_store": {
      "source": "example root store",
      "version": "test"
    },
    "legacy_versions_tested": true
  },
  "credits_remaining": 498
}

MCP

MCP tool call
{
  "tool": "check_ssl",
  "arguments": {
    "domain": "example.com"
  }
}
Compact MCP output
example.com's certificate on port 443 is trusted and valid for 62 more days, covering example.com and www.example.com. The server offers TLS 1.3.
Score: 100/100
example.com: trusted, issued by Example Trust Services, 62 days left, TLSv1.3
www.example.com: trusted, issued by Example Trust Services, 62 days left, TLSv1.3
Checked port 443 against the example root store; TLS 1.0 and 1.1 tested
No issues found.
Credits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC