# Get dashboard

Retrieve a single dashboard's general settings by ID.

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

`GET /app/dashboards/{id}`

Returns the general settings for a single dashboard.

Requires the `admin` role. Subscriber management flows use [List dashboards](/docs/api/status-dashboards/dashboards/list) and [Get dashboard components](/docs/api/status-dashboards/dashboards/components/get); they do not call this endpoint.

This endpoint returns only the core general fields. Tab-specific settings are retrieved via dedicated endpoints — see [Domains](/docs/api/status-dashboards/dashboards/domains/get), [Components](/docs/api/status-dashboards/dashboards/components/get), [Content](/docs/api/status-dashboards/dashboards/content/get), [Custom Code](/docs/api/status-dashboards/dashboards/custom-code/get), [Branding](/docs/api/status-dashboards/dashboards/branding/get), [Email Sender](/docs/api/status-dashboards/dashboards/branding/email-sender/get), [Widget](/docs/api/status-dashboards/dashboards/widget/get), [API](/docs/api/status-dashboards/dashboards/api/get), and [Whitelabel](/docs/api/status-dashboards/dashboards/whitelabel/get).

***

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

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

```json
{
  "dashboard": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "tenantId": "f47ac10b-58cc-4372-a567-0e02b2c3d480",
    "name": "Production Status",
    "subdomain": "acme",
    "description": "Status dashboard for all Acme services",
    "systemMessage": "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"Welcome to Acme's status dashboard.\"}]}]}",
    "enabled": true,
    "createdAt": "2026-01-10T12:00:00.000Z",
    "updatedAt": "2026-04-01T08:00:00.000Z"
  }
}
```

***

## Response fields
| Field           | Type             | Description                                                                                                                                                          |
| --------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`            | string           | Unique dashboard ID (UUID).                                                                                                                                          |
| `tenantId`      | string           | Organization ID.                                                                                                                                                     |
| `name`          | string           | Dashboard display name.                                                                                                                                              |
| `subdomain`     | string           | Subdomain slug.                                                                                                                                                      |
| `description`   | string           | Short dashboard description.                                                                                                                                         |
| `systemMessage` | string \| absent | Optional message at the top of the status dashboard. Rich text field. See [Rich text fields](/docs/api#rich-text-fields). Max 1,000 characters. Absent when not set. |
| `enabled`       | boolean          | Whether the dashboard is publicly accessible.                                                                                                                        |
| `createdAt`     | string           | ISO 8601 UTC creation timestamp.                                                                                                                                     |
| `updatedAt`     | string           | ISO 8601 UTC last-updated timestamp.                                                                                                                                 |

***

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