MonitorsDomain expiry monitoring
List Customer Domains (Org)
Lists customer domains within an organization (pagination + search).
GET /api/customer-domains
Query Parameters
organizationId(optional): defaults to your session organizationcustomerId(optional): accepts the customer public UUID (recommended) or a legacy numeric customer IDsearch(optional)page(optional, default1)perPage(optional, default50, max200)
Example (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
curl -X GET "$BASE_URL/api/customer-domains?organizationId=1&page=1&perPage=50" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Response
Returns a paginated response:
{
"items": [
{
"id": 1,
"publicId": "34eb0ec1-315d-45c4-aefe-0e5d12b11183",
"customerId": 2,
"customerName": "Zaskoku & Haupt GbR",
"customerPublicId": "6764e84f-f02a-43e6-a46d-cecaec556723",
"label": null,
"domainName": "digitalduett.com",
"status": "active",
"expiryWarningDays": 30,
"expiryErrorDays": 7,
"createdAt": "2026-02-13T21:21:03.001Z",
"updatedAt": "2026-02-13T21:21:03.001Z",
"expiry": {
"domainExpiresAt": "2026-12-20T20:44:45.000Z",
"domainRegistrar": "NameCheap, Inc.",
"isExpired": false,
"lastError": null,
"lastCheckedAt": "2026-04-03T10:59:00.321Z",
"lastChangedAt": "2026-04-03T10:59:00.321Z",
"lastNotifiedWarningAt": null,
"lastNotifiedErrorAt": null,
"lastNotifiedExpiredAt": null
}
}
],
"total": 0,
"page": 1,
"perPage": 50
}Each item includes flat customer fields plus an expiry object (or null).
Common errors
400 Organization ID requiredwhen the organization cannot be derived400query validation errors (e.g. invalidorganizationId,customerId,page,perPage)401 Unauthorizedwhen you are not logged in403 Forbiddenwhen you cannot access the organization