check_certificate
Check one domain's TLS certificate and return a verdict: status OK | WARN | CRITICAL | UNKNOWN, judged from the certificate chain the server actually serves — measured from Korean point A (full chain and CRL revocation) plus Korean point B and an overseas point on the Globalping public measurement network (per-point results in measuredFrom; disagreement between points is a WARN) — verification (expired, not yet valid, hostname mismatch, self-signed, untrusted root, missing intermediate, revoked via CRL), days left, renewal point, a newer certificate issued but not deployed (CT logs), the served chain and the issuing CA's incident history. If the server cannot be measured the status is UNKNOWN and CT logs are shown only as an estimate — never as OK. Set detail=true to include the full chain in the text output.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| port | No | TLS port (default 443). Implicit TLS: 8443 4443 9443 6443 636 465 993 995 853 5061 3269 8883; STARTTLS: 25 587 (SMTP), 143 (IMAP), 110 (POP3), 389 (LDAP). Or pass domain as host:port | |
| detail | No | Include the full certificate chain in the text output (default false) | |
| domain | Yes | Domain name, e.g. example.com | |
| critDays | No | Days before expiry that count as CRITICAL "expiring soon" (default 15; must be < warnDays) | |
| warnDays | No | Days before expiry that count as WARN (default 30; the default shrinks for short-lived certificates) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | ||
| status | Yes | UNKNOWN = could not be measured (never treat as OK) | |
| reasons | Yes | ||
| headline | Yes | One-line verdict (Korean) |