Security & delivery

GET/api/v1/ssl-checker

PacketFlo SSL Certificate Checker API

Cost: 2 credits per request

Issuer, expiry, chain of trust, and SAN coverage.

ParameterTypeRequiredDescription
domainstringYesDomain 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

FieldWhat it tells you
commonName / subjectAlternativeNames / issuerCertificate identity, covered names and issuer.
validFrom / expiryDate / daysRemainingValidity dates and remaining days.
hostnameMismatch / trustErrorHostname or chain-trust failure when present.
chain / signatureAlgorithmPresented 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 statusMeaning
200The diagnostic returned a result in data, with ok: true and version information in meta. Read the diagnostic fields to determine the target's condition.
400Invalid or blocked input, or a lookup/check failure that could not be returned as a diagnostic result. Read error for details.
401Missing, invalid or revoked API key.
429The request would exceed the key's available credit budget.
Port Checker