Site renewal

Read a site’s renewal state from a renewal-email link

No sign-in: the HMAC signature in the link scopes it to one site. Read-only.

get/site-renewal/link

Request

  • Base URL: https://api.nippy.host
  • URL: https://api.nippy.host/site-renewal/link
  • Auth: none declared

Query parameters

sitestring uuid required

The site query parameter.

sigstring required

The sig query parameter.

Response

siteIdstring uuid required
subdomainstring required
publicUrlstring required
state'online' | 'expired' | 'no_renewal_needed' | 'unavailable' required
renewalDueAtstring date-time nullable

When the site next needs keeping online. Set only for online.

offlineAtstring date-time nullable

When the site goes offline without a click: seven days after the renewal email, and never less than 24 hours after the "goes offline tomorrow" reminder. Set only for online.

deletesAtstring date-time nullable

When an expired site and its files are deleted: never less than seven days after the deletion warning or 24 hours after the "will be deleted tomorrow" notice.

Example response

{
  "subdomain": "my-site",
  "publicUrl": "https://my-site.nippy.site"
}

Changes