Docs/APIs/SSL Certificate Checker

SSL Certificate Checker

Check SSL certificate

OperationalCredits 10 per callp50 802msDomain DataStar

Overview

An SSL checker API and certificate verification API for expiry monitoring, domain audits and CI checks: send a hostname, get its live SSL certificate back as JSON. SSL Checker opens a real TLS connection to the site, reads the certificate and the chain the server sends, and validates it the way a client does (trusted root, hostname match, expiry), returning the verifier's error code such as CERT_HAS_EXPIRED or UNABLE_TO_VERIFY_LEAF_SIGNATURE when it fails. Alongside issuer, subject, key type, key size and signature algorithm, it reports the TLS protocol and cipher negotiated, the Strict-Transport-Security policy, OCSP stapling and embedded Certificate Transparency SCTs, plus derived checks: days until expiry, an expiring-soon flag and self-signed detection. To see which TLS versions a server still accepts, pair it with TLS Checker.

Live Test SSL Certificate Checker API →

Endpoint

One host, one path per API. The block below shows this call in four languages; every one of them is the same HTTP request. Making requests covers the timeouts, retries and parameter rules that apply to all of them. The SDKs wrap the same call in a typed client.

GEThttps://api.apiverve.com/v1/sslchecker
curl "https://api.apiverve.com/v1/sslchecker?domain=ebay.com" \
  -H "x-api-key: your_api_key_here"

Replace your_api_key_here with the key from your dashboard. When the inputs arrive as a list rather than one at a time, batch requests run up to 200 of them through this same API in a single call.

Authentication

Send your key in the x-api-key header. That is the only auth step — there is no token exchange and no per-endpoint scope to configure. Authentication covers creating, rotating and revoking keys.

401 is the only auth verdict

A 401 means the key is missing, invalid or expired. A 403 means the key is valid but not permitted here — blocked by a key restriction or an IP allow-list. Running out of credits is a 429.

Parameters

Sent in the query string. Premium parameters are accepted on every plan but only take effect on plans that include them.

ParameterTypeDescription
domainRequiredstringThe domain of the website to check the SSL certificate of
domain

Response

Every API returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape. Response format covers the envelope, the other output formats and how premium fields are withheld.

Sample response
{
  "status": "ok",
  "error": null,
  "data": {
    "subject": {
      "C": "US",
      "ST": "California",
      "O": "eBay, Inc.",
      "CN": "ebay.com"
    },
    "issuer": {
      "C": "GB",
      "O": "Sectigo Limited",
      "CN": "Sectigo Public Server Authentication CA OV R40"
    },
    "subjectaltname": "DNS:ebay.com, DNS:befr.ebay.be, DNS:benl.ebay.be, DNS:cafr.ebay.ca, DNS:e-bay.com, DNS:e-bay.it, DNS:ebay.at, DNS:ebay.be, DNS:ebay.ca, DNS:ebay.ch, DNS:ebay.co.nz, DNS:ebay.co.uk, DNS:ebay.com.au, DN…",
    "infoAccess": {
      "CA Issuers - URI": [
        "http://crt.sectigo.com/SectigoPublicServerAuthenticationCAOVR40.crt"
      ],
      "OCSP - URI": [
        "http://ocsp.sectigo.com"
      ]
    },
    "ca": false,
    "bits": 2048,
    "valid_from": "Oct  6 00:00:00 2026 GMT",
    "valid_to": "Apr 22 23:59:59 2027 GMT",
    "serialNumber": "19FD41E42C169CF248511D2BEE660A83",
    "domain": "ebay.com",
    "isExpired": false,
    "isValid": true,
    "daysUntilExpiry": 182,
    "isExpiringSoon": false,
    "isSelfSigned": false,
    "protocol": "TLSv1.3",
    "cipher": "TLS_AES_128_GCM_SHA256",
    "isTrusted": true,
    "trustError": null,
    "hostnameMatches": true,
    "chain": [
      {
        "subject": "ebay.com",
        "issuer": "Sectigo Public Server Authentication CA OV R40",
        "validTo": "Apr 22 23:59:59 2027 GMT",
        "isCA": false
      },
      {
        "subject": "Sectigo Public Server Authentication CA OV R40",
        "issuer": "Sectigo Public Server Authentication Root R46",
        "validTo": "May 13 23:59:59 2040 GMT",
        "isCA": true
      },
      {
        "subject": "Sectigo Public Server Authentication Root R46",
        "issuer": "USERTrust RSA Certification Authority",
        "validTo": "Jan 18 23:59:59 2038 GMT",
        "isCA": true
      },
      {
        "subject": "USERTrust RSA Certification Authority",
        "issuer": "USERTrust RSA Certification Authority",
        "validTo": "Jan 18 23:59:59 2038 GMT",
        "isCA": true
      }
    ],
    "keyType": "RSA",
    "signatureAlgorithm": "sha256WithRSAEncryption",
    "hasEmbeddedSCTs": true,
    "ocspStapled": true,
    "hsts": {
      "present": true,
      "maxAge": 31536000,
      "includeSubDomains": false,
      "preload": false
    }
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

FieldTypeExampleDescription
subjectPremiumobject{...}Certificate subject information including country, state, organization, and common name
CPremiumstring"US"Country code of the certificate subject
STPremiumstring"California"State or province of the certificate subject
OPremiumstring"eBay, Inc."Organization name of the certificate subject
CNPremiumstring"ebay.com"Common name of the certificate subject domain
issuerPremiumobject{...}Certificate issuing authority information including country, organization, and common name
CPremiumstring"GB"Country code of the certificate issuer
OPremiumstring"Sectigo Limited"Organization name of the certificate issuing authority
CNPremiumstring"Sectigo Public Server Authentication CA OV R40"Common name of the certificate authority
subjectaltnamePremiumstring"DNS:ebay.com, DNS:befr.ebay.be, DNS:benl.ebay.be, DNS:cafr.ebay.ca, DNS:e-bay.com, DNS:e-bay.it, DNS…"Alternative subject names included in the certificate
infoAccessPremiumobject{...}Information access extension with CA issuers and OCSP URIs
CA Issuers - URIPremiumarray[http://crt.sectigo.com/SectigoPublicServerAuthenticationCAOVR40.crt]URLs to CA issuer certificates for validation
OCSP - URIPremiumarray[http://ocsp.sectigo.com]Online Certificate Status Protocol URLs for validation
cabooleanfalseIndicates if certificate is a certificate authority
bitsnumber2048Key size in bits representing certificate strength
valid_fromstring"Oct 6 00:00:00 2026 GMT"Certificate validity start date and time in GMT
valid_tostring"Apr 22 23:59:59 2027 GMT"Certificate validity end date and time in GMT
serialNumberPremiumstring"19FD41E42C169CF248511D2BEE660A83"Unique serial number of the SSL certificate
domainstring"ebay.com"Domain name the certificate was checked for
isExpiredbooleanfalseWhether the certificate is past its valid_to date
isValidbooleantrueWhether the current time is within the certificate's validity window (valid_from to valid_to)
daysUntilExpiryPremiumnumber182Whole days until the certificate expires (negative if already expired)
isExpiringSoonPremiumbooleanfalseWhether the certificate expires within the next 30 days
isSelfSignedPremiumbooleanfalseWhether the certificate is self-signed (subject and issuer are the same entity), which browsers do not trust
protocolstring"TLSv1.3"TLS version negotiated for this check, e.g. TLSv1.3
cipherstring"TLS_AES_128_GCM_SHA256"Cipher suite negotiated for this check (IANA name where known, e.g. TLS_AES_128_GCM_SHA256)
isTrustedbooleantrueWhether the certificate chain verifies to a trusted root CA (Node.js's bundled Mozilla root store) and is within its validity dates. Hostname matching is reported separately in hostnameMatches. Revocation is not checked
trustErrorobjectnullThe verifier error code when isTrusted is false, e.g. CERT_HAS_EXPIRED, DEPTH_ZERO_SELF_SIGNED_CERT, SELF_SIGNED_CERT_IN_CHAIN or UNABLE_TO_VERIFY_LEAF_SIGNATURE (usually a missing intermediate); null when trusted
hostnameMatchesbooleantrueWhether the certificate's subject alternative names (or common name, if it has none) cover the checked domain
chainPremiumarray[4]The certificate chain from the site certificate upward: what the server sent, plus the trust-store root when one was found
subjectPremiumstring"ebay.com"Common name (or organization) of this certificate
issuerPremiumstring"Sectigo Public Server Authentication CA OV R40"Common name (or organization) of the certificate that signed it
validToPremiumstring"Apr 22 23:59:59 2027 GMT"Expiry date and time of this certificate in GMT
isCAPremiumbooleanfalseWhether this certificate is a certificate authority
keyTypestring"RSA"Public key algorithm of the certificate: RSA, EC, Ed25519, Ed448, RSA-PSS or DSA
signatureAlgorithmstring"sha256WithRSAEncryption"Algorithm the issuer signed the certificate with, e.g. sha256WithRSAEncryption or ecdsa-with-SHA256 (dotted OID if unrecognised)
hasEmbeddedSCTsbooleantrueWhether the certificate embeds Certificate Transparency SCTs (RFC 6962 extension). SCTs delivered by TLS extension or OCSP instead are not detected
ocspStapledbooleantrueWhether the server stapled an OCSP response to the handshake
hstsobject{...}Strict-Transport-Security policy from the response to GET /; null if the server completed the handshake but returned no HTTP response
presentbooleantrueWhether the response carried a Strict-Transport-Security header
maxAgenumber31536000max-age in seconds (0 means HSTS is switched off); null if absent
includeSubDomainsbooleanfalseWhether the policy includes the includeSubDomains directive
preloadbooleanfalseWhether the policy includes the preload directive

Errors

Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change. Error handling covers the full status list and which of them are worth retrying.

StatusMeaningWhat to do
400Input was rejectedRead error; it names the parameter.
401Key missing or invalidCheck the header name and the key value.
403Key valid, but not permittedA key restriction or IP allow-list; see key scoping.
429Rate limited, or out of creditsRead error to tell them apart; see rate limits.

Start from a template

A working app built on this API, ready to deploy with your own key. Vercel asks for the key when you deploy; the code is on GitHub to change first.

Use cases

SSL Monitoring and Expiry Alerts
DevOps teams check their domains daily from a cron job or uptime monitor, alerting on certificates close to expiry, failed chain validation or a hostname mismatch before browsers start showing warnings.
Customer Domain Audits
When clients point custom hostnames to a SaaS platform, automated onboarding scripts verify validity status and key strength before activating traffic.
Certificate Chain and Key Audits
Security teams sweep corporate web properties for setups that need fixing: certificates that fail validation, servers missing an intermediate, RSA keys under 2048 bits, SHA-1 signatures or no HSTS policy.
Partner Domain Verification
To prevent broken checkouts, e-commerce marketplaces inspect partner payment gateways to confirm validity windows before routing shopper transactions.

Other ways to use SSL Certificate Checker

Set up SSL Certificate Checker on APIVerve, or reach the same source a different way. Your APIVerve account and credits work on all of them — one key, one balance.

Give it to an AI agentConnect over MCP and your agent calls it as a native tool — Claude, Cursor, ChatGPT.VerveKit →Reference →
Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →
Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.VerveContext →Reference →

More in Domain Data:

Was this page helpful?