# Get email domain allowlist

Retrieve the email domain allowlist configuration for a dashboard.

Source: https://statusdashboard.com/docs/api/status-dashboards/dashboards/subscriptions/email-domain-allowlist-get

`GET /app/dashboards/{id}/subscriptions/email-domain-allowlist`

Returns the current email domain allowlist for a dashboard. Requires the **Email** plan capability (`emailEnabled`).

***

## 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/subscriptions/email-domain-allowlist \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

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

```json
{
  "enabled": false,
  "domains": [],
  "limits": {
    "emailDomainAllowlist": 5
  }
}
```

`limits.emailDomainAllowlist` is the maximum number of domains this dashboard may store. Contact support to request an increase.

***

## Response fields
| Field                         | Type      | Description                                                                                                                                                                                                      |
| ----------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enabled`                     | boolean   | Whether the allowlist is enforced on public email subscribe. Same semantics as [Toggle email domain allowlist](/docs/api/status-dashboards/dashboards/subscriptions/email-domain-allowlist-toggle#request-body). |
| `domains`                     | string\[] | Allowed email domains. Same format as [Update email domain allowlist](/docs/api/status-dashboards/dashboards/subscriptions/email-domain-allowlist-update#request-body).                                          |
| `limits.emailDomainAllowlist` | number    | Max domains per dashboard for your organization.                                                                                                                                                                 |

***

## Error responses
| Status | When                                                  |
| ------ | ----------------------------------------------------- |
| `400`  | Missing dashboard ID                                  |
| `403`  | Org plan does not include email subscriptions         |
| `404`  | Dashboard not found or not owned by your organization |