For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get SSL status

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…

Get SSL status

get

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.

Authorizations
AuthorizationstringRequired

API Token authentication

Path parameters
usernamestringRequiredExample: u123456789
domainstringRequired

Domain name

Example: mydomain.tld
Responses
200

Success response

application/json
statusstring · enumRequired

Current certificate status

Example: activePossible values:
providerstring · enum · nullableRequired

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.

Example: letsencryptPossible values:
is_lifetimebooleanRequired

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.

Example: true
is_https_redirect_enabledbooleanRequired

Whether HTTP requests to the website are redirected to HTTPS

Example: true
expires_atstring · date-time · nullableRequired

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

Example: 2027-01-15T10:30:00Z
last_errorstring · nullableRequired

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

Example: Max attempts to retry were reached
get/api/hosting/v1/accounts/{username}/websites/{domain}/ssl/status
GET /api/hosting/v1/accounts/{username}/websites/{domain}/ssl/status HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "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"
}

Last updated

Was this helpful?