Get email domain allowlist — StatusDashboard Docs

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 for required headers.

This endpoint takes no request body.

Sample request

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

{
  "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.
`domains`	string[]	Allowed email domains. Same format as Update email domain allowlist.
`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