Skip to content
Gridlode
Docs · Reference

SSL Certificate Check

GET /v1/domain/ssl1 credit / requestcache 60 min

Connects to a host over TLS and reports whether its certificate is trusted, who issued it, the names it covers, when it expires (with days remaining), serial number, signature and key type, plus the TLS version and cipher the server negotiated. Invalid certificates are still decoded and the reason is explained in plain English.

Query parameters

domain
string · required
Hostname to inspect, e.g. example.com or api.example.com (URLs accepted).
port
integer
TLS port: 443 or 8443.
Default: 443
Allowed: 443, 8443
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

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

    Try it without code on the SSL Certificate Check API page.