# Get IP allowlist

Retrieve the IP allowlist configuration for a dashboard.

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

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

Returns the current IP allowlist configuration for a dashboard. Requires the **IP Allowlist** feature entitlement.

***

## 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/ipallowlist \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

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

```json
{
  "enabled": true,
  "allowlist": ["203.0.113.0/24", "198.51.100.42", "2001:db8::1"]
}
```

When no allowlist has been configured yet, `enabled` and `allowlist` are `undefined` (absent from the response).

***

## Response fields
| Field       | Type                 | Description                                                                                                                                                                                        |
| ----------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enabled`   | boolean \| omitted   | Whether IP allowlist enforcement is active. Same semantics as [Toggle IP allowlist](/docs/api/status-dashboards/dashboards/ipallowlist/toggle#request-body). Omitted when never configured.        |
| `allowlist` | string\[] \| omitted | Allowed IP addresses and CIDR ranges. Same format and constraints as [Update IP allowlist](/docs/api/status-dashboards/dashboards/ipallowlist/update#request-body). Omitted when never configured. |

***

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