---
title: "Get Domain"
description: "Returns one custom app domain of your organization, in the same { domain, dns } shape as Add Domain. Requires the admin role."
---

`GET /api/organization/whitelabel/domains/{id}`

## Access

Organization admins only, as for [List Domains](/api/whitelabel/list-domains). Only domains with the role `app` are returned.

## Example (cURL)

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

curl -X GET "$BASE_URL/api/organization/whitelabel/domains/3" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Response

`200 OK`

```json
{
  "domain": {
    "id": 3,
    "hostname": "monitoring.acme.example",
    "status": "active",
    "role": "app",
    "isPrimary": true,
    "verificationToken": "uptimeify-verify-def456",
    "verifiedAt": "2026-06-02T08:00:00.000Z",
    "createdAt": "2026-06-01T08:00:00.000Z",
    "updatedAt": "2026-06-02T08:00:00.000Z"
  },
  "dns": {
    "txtName": "_verify-status.monitoring.acme.example",
    "txtValue": "uptimeify-verify-def456"
  }
}
```

## Common errors

- `400 Bad Request` (`invalidDomainId`) when the id is not a positive number
- `401 Unauthorized` when you are not logged in
- `403 Forbidden` when you are not an organization admin
- `404 Not Found` (`domainNotFound`) when the domain does not exist or belongs to another organization
