Security & delivery
/api/v1/ssl-checkerPacketFlo SSL Certificate Checker API
Issuer, expiry, chain of trust, and SAN coverage.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Domain to check (connects on port 443). |
Example request
curl "https://packetflo.io/api/v1/ssl-checker?domain=example.com&api_key=YOUR_API_KEY"
Example response
{ "ok": true, "data": { "domain": "example.com", "status": "valid", "trustError": null, "commonName": "example.com", "subjectAlternativeNames": ["example.com", "www.example.com"], "issuer": "WE1", "validFrom": "2026-09-05T22:29:39.000Z", "expiryDate": "2026-12-04T23:29:33.000Z", "daysRemaining": 86, "signatureAlgorithm": "ecdsa-with-SHA256", "chain": [ { "commonName": "example.com", "issuer": "WE1", "validFrom": "2026-09-05T22:29:39.000Z", "validTo": "2026-12-04T23:29:33.000Z" }, { "commonName": "WE1", "issuer": "GTS Root R4", "validFrom": "2023-12-13T09:00:00.000Z", "validTo": "2029-02-20T14:00:00.000Z" } ] }, "meta": { "tool": "ssl-checker", "version": "v1" } }
Reading the result
valid means the hostname, validity period and certificate chain all passed. mismatch, expired and untrusted name distinct failures; warning means expiry is within 30 days.
Response fields
| Field | What it tells you |
|---|---|
commonName / subjectAlternativeNames / issuer | Certificate identity, covered names and issuer. |
validFrom / expiryDate / daysRemaining | Validity dates and remaining days. |
hostnameMismatch / trustError | Hostname or chain-trust failure when present. |
chain / signatureAlgorithm | Presented certificate-chain details and algorithm information, with n/a when unavailable. |
Scope and limits
Inspects one validated public IP on port 443 with a three-second TLS timeout. The connection permits untrusted certificates for inspection, but reports them as untrusted rather than valid.
Authentication and errors
Send your key in the x-api-key header, or the supported api_key query parameter. Each request uses 2 credits from the key's shared 300-credit rolling 24-hour budget. Credits are charged before parameter validation. Successful responses and quota errors include usage headers; GET and OPTIONS support CORS.
| API status | Meaning |
|---|---|
200 | The diagnostic returned a result in data, with ok: true and version information in meta. Read the diagnostic fields to determine the target's condition. |
400 | Invalid or blocked input, or a lookup/check failure that could not be returned as a diagnostic result. Read error for details. |
401 | Missing, invalid or revoked API key. |
429 | The request would exceed the key's available credit budget. |