Using SSLreminder via API is easy

Prefer curl (or code) over clicking around? Our Account API makes it straightforward to add, list, and remove monitored domains. And there’s a free, no-auth certificate checker for quick lookups.

Quick start

Grab your API token from your SSLreminder account (paid plans). Use it as a Bearer token in the Authorization header.
Ping the health endpoint (no auth needed):

curl https://api.sslreminder.pro/healthy
# → {"status":"Healthy"}

Core endpoints (with curl)

Add a domain

curl -X POST https://api.sslreminder.pro/domain_names/ \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"domain_name":"example.com"}'

List domains

curl -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  https://api.sslreminder.pro/domain_names/

Get one domain

curl -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  https://api.sslreminder.pro/domain_names/example.com
  # → 
    {
      "domain_name":"example.com",
      "certificate_checked_at":"2024-09-27 08:45:15",
      "valid_until":"2025-01-22 07:03:00"
    }

Delete a domain

curl -X DELETE -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  https://api.sslreminder.pro/domain_names/example.com

Free certificate check (no token)

Need a quick expiry status for any host? Use the free, AI-friendly endpoint:

curl "https://api.sslreminder.pro/v1/free/ai/check?domain=example.com"
# → {
    "domain":"example.com",
    "status":"valid",
    "issuer":"...",
    "not_after":"...",
    "days_to_expiry":123,...
    }

This endpoint sanitizes input, supports CORS, and has rate limits (60/minute, 5,000/day) for unauthenticated calls.

Tiny Python example

import requests

API = "https://api.sslreminder.pro"
token = "YOUR_API_TOKEN"
hdrs = {"Authorization": f"Bearer {token}"}

# Add a domain
requests.post(f"{API}/domain_names/", json={"domain_name":"example.com"}, headers=hdrs)
  .raise_for_status()

# Fetch it
r = requests.get(f"{API}/domain_names/example.com", headers=hdrs)

print(r.json())  
# {'domain_name': 'example.com', 'certificate_checked_at': ..., 'valid_until': ...}

That’s pretty much it, a couple of headers and JSON, and you’re automated.

When you’re ready to go deeper (errors, schemas, examples), check the full API reference at https://api.sslreminder.pro/docs

If you need help, reach us via https://sslreminder.pro/contact.