---
title: "Domain-Ablauf (Websites) auflisten"
description: "Listet Websites mit den zuletzt bekannten Informationen zum Domain-Ablaufdatum auf."
---

`GET /api/domains`

## Query Parameter

- `organizationId` (optional): Standard ist deine Session-Organisation
- `customerId` (optional)
- `search` (optional)
- `page` (optional, Default `1`)
- `perPage` (optional, Default `50`, max `200`)

## Beispiel (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

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

## Antwort

```json
{
  "items": [
    {
      "id": 101,
      "name": "Example Website",
      "url": "https://deinkunde.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
}
```

## Feldnotizen

- `expiryStatus` kann sein: `ok`, `warning`, `critical`, `expired`, `unknown`, `disabled`.
- `daysUntilExpiry` ist `null`, wenn kein Ablaufdatum verfügbar ist.

## Häufige Fehler

- `400 Organization ID required` wenn keine Organisation abgeleitet werden kann
- `400 Invalid customerId` wenn `customerId` ungültig ist
- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` wenn du keinen Zugriff auf die Organisation hast