Certificates

Probe one of your hostnames now (TLS handshake against the platform)

post/certificates/check

Request

  • Base URL: https://hostingsurge.com/api/v1
  • URL: https://hostingsurge.com/api/v1/certificates/check
  • Auth: one of:
    • HTTP bearer
    • API key in cookie __Host-hs_session

Query parameters

orgIdstring

Organization id (required when you belong to several)

Request body

hostnamestring required

Response

Current observation

idstring uuid required
hostnamestring required
kind'default' | 'custom' | 'platform' required

project default hostname, custom domain, or one of the platform's own hosts

organizationIdstring uuid nullable required
projectIdstring uuid nullable required
projectNamestring nullable required
status'valid' | 'expiring' | 'expired' | 'error' | 'pending' required
statusReasonstring nullable required
checkedAtstring nullable required

ISO-8601 timestamp

nextCheckAtstring nullable required

ISO-8601 timestamp

managedCertificateIdstring uuid nullable required

the active certificate the platform manages for this hostname (uploaded, free or purchased)

coveredByWildcardboolean required

served by the platform's wildcard certificate

source'automatic' | 'managed' | 'wildcard' required

automatic = Let's Encrypt through the proxy; managed = a certificate of yours

Changes

No recorded changes to this operation across all 1 revision of this API.