arrow_back All endpoints

SSL Certificate Check

POST/api/v1/tools/ssl-check2 credits per callssltlscertificateexpirysecurity

Opens a TLS connection to the host and reports what certificate it presents - who issued it, when it expires, which hostnames it covers and whether the chain validates. The usual reason to call this is to catch a certificate that is about to expire before a visitor does.

receipt_long
Why 2 credits?

Requires a real TLS handshake with the target host, which costs a round trip and some CPU for certificate parsing - a few times the work of a cached DNS answer.

Any HTTP client works. Replace the key with one from your dashboard.

bash
curl -X POST https://toolkitbackend-j69m.onrender.com/api/v1/tools/ssl-check \
  -H "Authorization: Bearer tb_live_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "host": "example.com"
}'

Input

FieldTypeRequiredDefaultDescription
hoststringrequired- Hostname to connect to, without a scheme. Example: example.com

Output

FieldTypeDescription
hoststringThe host that was checked.
issuerstringCertificate authority that issued the certificate.
subjectstringCertificate subject.
validFromstringISO-8601 start of the validity window.
validTostringISO-8601 expiry.
daysRemainingintegerWhole days until expiry. Negative when already expired.
subjectAlternativeNamesarrayEvery hostname the certificate covers.

Try it

Sends a real POST /api/v1/tools/ssl-check from your browser and charges 2 credits to your account.

Sign in to run this endpoint. New accounts start with free credits.