# Get dashboard domains

Retrieve the subdomain and custom domain settings for a dashboard.

Source: https://statusdashboard.com/docs/api/status-dashboards/dashboards/domains/get

`GET /app/dashboards/{id}/domains`

Returns the current subdomain and custom domain configuration for a dashboard. Requires **admin** role.

***

## Path parameters
| Parameter | Description                |
| --------- | -------------------------- |
| `id`      | The UUID of the dashboard. |

***

## Request
See [API Basics](/docs/api) for required headers.

This endpoint takes no request body.

***

## Sample request
```bash
curl https://api.statusdashboard.com/app/dashboards/a1b2c3d4-e5f6-7890-abcd-ef1234567890/domains \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

## Sample response
**Status: `200 OK`**

```json
{
  "subdomain": "acme",
  "customDomain": "status.acme.com",
  "customDomainStatus": "active"
}
```

## Response fields
| Field                   | Type   | Description                                                                                                             |
| ----------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------- |
| `subdomain`             | string | The subdomain slug (e.g. `acme` maps to `acme.yourdomain.com`).                                                         |
| `customDomain`          | string | The custom domain, if configured. Absent when no custom domain is set.                                                  |
| `customDomainStatus`    | string | One of `awaiting_dns`, `validating`, `active`, `removing`, `failed`. Absent when no custom domain is set.               |
| `customDomainError`     | string | Human-readable error when `customDomainStatus` is `failed`, or when verification was lost and status is `awaiting_dns`. |
| `customDomainCreatedAt` | string | ISO 8601 timestamp when the custom domain was first saved.                                                              |
| `customDomainUpdatedAt` | string | ISO 8601 timestamp of the last custom domain status change.                                                             |
| `cloudFrontTenantId`    | string | Internal provisioning identifier. Present after activation has been requested at least once.                            |

***

## Error responses
| Status | When                                                                 |
| ------ | -------------------------------------------------------------------- |
| `403`  | Insufficient permissions.                                            |
| `404`  | Dashboard not found or does not belong to the caller's organization. |