Hosting: SSL

Get SSL status

Changed on

Returns the SSL state of the website: the certificate status and provider, whether the certificate is a lifetime one managed by the platform, whether HTTP requests are redirected to HTTPS, when the certificate stops being valid and the last installation error.

installing and waiting_for_retry mean an installation is in progress. failed means the last installation gave up, or the website was not updated for 60 minutes while installing; last_error holds the reason when it is a known message, otherwise it is null. expired means the assigned certificate's validity has ended. not_installed means no certificate is assigned. Free subdomains use a platform-managed certificate: with no installation recorded they report active with provider and expires_at null.

get/api/hosting/v1/accounts/{username}/websites/{domain}/ssl/status

Request

  • Base URL: https://developers.hostinger.com
  • URL: https://developers.hostinger.com/api/hosting/v1/accounts/{username}/websites/{domain}/ssl/status
  • Auth: HTTP bearer

Path parameters

usernamestring required
Example:u123456789
domainstring required
Example:mydomain.tld

Domain name

Response

Success response

status'not_installed' | 'installing' | 'waiting_for_retry' | 'active' | 'expired' | 'failed' required

Current certificate status

provider'custom' | 'letsencrypt' | 'zerossl' | 'googlessl' | 'hssl' nullable required

Provider of the assigned certificate, or of the last recorded installation when none is assigned. custom means an uploaded certificate. Null when no certificate is assigned and no installation is recorded, which is also the case for free subdomains on the platform-managed certificate.

is_lifetimeboolean required

Whether the certificate comes from a lifetime provider managed by the platform, not an uploaded one. Follows provider: it reflects the last recorded installation when no certificate is assigned, and is false when provider is null.

is_https_redirect_enabledboolean required

Whether HTTP requests to the website are redirected to HTTPS

expires_atstring date-time nullable required

End of the assigned certificate validity period; null when no certificate details are available.

last_errorstring nullable required

Last installation error, when it is one of the known displayable messages

Example response

{
  "status": "active",
  "provider": "letsencrypt",
  "is_lifetime": true,
  "is_https_redirect_enabled": true,
  "expires_at": "2027-01-15T10:30:00Z",
  "last_error": "Max attempts to retry were reached"
}

Changes