Uptimeify Docs
MonitorsDomain expiry monitoring

List Domain Expiry (Websites)

Lists websites with latest known domain expiry information.

GET /api/domains

Query Parameters

  • organizationId (optional): defaults to your session organization
  • customerId (optional)
  • search (optional)
  • page (optional, default 1)
  • perPage (optional, default 50, max 200)

Example (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X GET "$BASE_URL/api/domains?organizationId=1&page=1&perPage=50" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Response

{
  "items": [
    {
      "id": 101,
      "name": "Example Website",
      "url": "https://example.com",
      "status": "active",
      "customerId": 10,
      "customerName": "Example Customer",
      "checkDomainExpiryEnabled": true,
      "domainExpiryNoticeDays": 30,
      "domainExpiryErrorDays": 7,
      "domainExpiresAt": "2026-12-31T00:00:00.000Z",
      "domainRegistrar": "Example Registrar",
      "lastDomainCheckAt": "2026-03-03T10:00:00.000Z",
      "daysUntilExpiry": 303,
      "expiryStatus": "ok"
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 50
}

Field notes

  • expiryStatus can be: ok, warning, critical, expired, unknown, disabled.
  • daysUntilExpiry is null when no expiration date is available.

Common errors

  • 400 Organization ID required when the organization cannot be derived
  • 400 Invalid customerId when customerId is invalid
  • 401 Unauthorized when you are not logged in
  • 403 Forbidden when you cannot access the organization

On this page