API reference

A small REST API to manage the certificates you monitor. Authenticate with a bearer token created on the API page in your dashboard.

Authentication

Send your token in the Authorization header. All endpoints are scoped to the token’s account.

Authorization: Bearer {token}

Endpoints

GET/api/v1/hosts

List every certificate you monitor, with status and expiry.

curl -H 'Authorization: Bearer {token}' \
  https://sslnudge.com/api/v1/hosts

POST/api/v1/hosts

Start monitoring a new host. Body: { "host": "example.com", "port": 443, "label": "Marketing" }.

curl -X POST -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{"host":"example.com"}' \
  https://sslnudge.com/api/v1/hosts

GET/api/v1/hosts/{id}

Fetch a single monitored host by id.

curl -H 'Authorization: Bearer {token}' \
  https://sslnudge.com/api/v1/hosts/{id}

POST/api/v1/check

Check a certificate on demand and get its details back — nothing is stored.

curl -X POST -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{"host":"example.com"}' \
  https://sslnudge.com/api/v1/check

DELETE/api/v1/hosts/{id}

Stop monitoring a host and delete its history.

curl -X DELETE -H 'Authorization: Bearer {token}' \
  https://sslnudge.com/api/v1/hosts/{id}