Renewals API

Name: DomainOps
Author: Libriate

Query upcoming and past renewal dates for domains and SSL certificates. Use this to build renewal dashboards or integrate expiry data into your own tooling.

GET/api/v1/renewalsAuth required

Get renewal information for domains and/or SSL certificates within an optional date range.

Query Parameters

Parameter	Type	Required	Description
type	string	No	Filter by renewal type: domains or certificates
from	string	No	Start of date range, ISO 8601 format (e.g. 2026-01-01)
to	string	No	End of date range, ISO 8601 format
status	string	No	Filter by status: active, expired, or expiring_soon
limit	number	No	Max results, default 50
offset	number	No	Pagination offset, default 0

Response

json

{
  "renewals": [
    {
      "id": "uuid",
      "domain": "example.com",
      "type": "domain",
      "expiry_date": "2025-12-01",
      "days_until_expiry": 248,
      "status": "active"
    }
  ],
  "total": 1,
  "summary": {
    "expiring_soon": 3,
    "expired": 0,
    "active": 47
  }
}