---
title: "Verify Status Page Domain"
description: "Verifies DNS TXT records for a custom status page domain. Admin-only."
---

`POST /api/status-pages/domains/verify`

## Request Body

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domainId` | number | Yes | The domain ID to verify |

## Example (cURL)

```bash
curl -X POST "$BASE_URL/api/status-pages/domains/verify" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "domainId": 42 }'
```

## Response (success)

```json
{
  "verified": true,
  "status": "verified",
  "domain": {
    "id": 42,
    "hostname": "status.deinkunde.com",
    "status": "verified",
    "role": "status_page",
    "verificationToken": "abc123-def456-ghi789",
    "verifiedAt": "2026-05-01T12:00:00.000Z",
    "createdAt": "2026-05-01T11:00:00.000Z",
    "updatedAt": "2026-05-01T12:00:00.000Z"
  }
}
```

## Common errors

- `401 Unauthorized` when not authenticated
- `403 Forbidden` when not an admin
- `404 Not found` when the domain does not exist