Retrieve a website's certificate

GET

https://api.modulards.com/api/public/v1/sites/:site/certificate

GET

/api/public/v1/sites/:site/certificate

curl https://api.modulards.com/api/public/v1/sites/site/certificate \
     -H "Authorization: Bearer <token>"

200200 - Certificate

{
  "data": {
    "attributes": {
      "configured": true,
      "days_until_expiry": 39,
      "enabled": true,
      "issuer": {
        "c": "US",
        "cn": "R11",
        "o": "Let's Encrypt",
        "ou": null
      },
      "protocol": "TLSv1.3",
      "sans": [
        "acme-corp.com",
        "www.acme-corp.com"
      ],
      "ssl_status": "up",
      "subject": {
        "c": null,
        "cn": "acme-corp.com",
        "o": null,
        "ou": null
      },
      "valid_from": "2026-08-01 00:00:00",
      "valid_to": "2026-10-30 12:00:00"
    },
    "id": "101",
    "links": {
      "self": "https://api.modulards.com/api/public/v1/sites/101/certificate"
    },
    "type": "site-certificates"
  },
  "jsonapi": {
    "version": "1.1"
  }
}

Returns the summary of a website’s SSL certificate: whether certificate monitoring is set up, its status, who issued it, the dates it is valid between and how many days are left (negative once it has expired). Use it to spot certificates that are about to expire.

A website without certificate monitoring answers 200 with configured set to false and every other detail empty.

This request takes no query parameters: any parameter answers 422. Your role must be allowed to see certificates; without it the request answers 404.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Path parameters

sitestringRequired

Response

200 - Certificate

dataobjectOptional

jsonapiobjectOptional