# Get a single dashboard

Retrieves detailed information for a single dashboard by its ID, including its charts, sections, and variables.

[endpoint]
base_url = "https://telemetry.betterstack.com"
path = "/api/v2/dashboards/{id}"
method = "GET"

[[path_param]]
name = "id"
description = "The unique identifier of the dashboard."
required = true
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"
[/endpoint]

[responses]
[[response]]
status = 200
description = "The details of the specified dashboard."
body = '''
{
  "data": {
    "id": "1234",
    "type": "dashboard",
    "attributes": {
      "team_id": 123456,
      "team_name": "example-team",
      "name": "Sample Dashboard",
      "dashboard_group_id": 789,
      "refresh_interval": 30,
      "date_range_from": "now-3h",
      "date_range_to": "now",
      "created_at": "2025-01-20T15:00:00.000Z",
      "updated_at": "2025-01-21T10:00:00.000Z",
      "source_eligibility_sql": null,
      "variables": [
        {
          "name": "source",
          "variable_type": "source",
          "values": ["123"],
          "default_values": []
        },
        {
          "name": "environment",
          "variable_type": "string",
          "values": ["production"],
          "default_values": ["production"]
        }
      ],
      "charts": [
        {
          "id": 567,
          "chart_type": "line_chart",
          "name": "CPU Usage",
          "x": 0,
          "y": 0,
          "w": 6,
          "h": 4
        }
      ],
      "sections": [
        {
          "id": 890,
          "name": "Key Metrics",
          "y": 0,
          "collapsed": false
        }
      ],
      "has_overlaps": false
    }
  }
}
'''

[[response]]
status = 401
description = "Invalid or missing authentication token."

[[response]]
status = 404
description = '''Resource with the provided ID was not found.'''
body = '''
{
  "errors": "Resource with the provided ID was not found"
}
'''
[/responses]

## Example cURL

```shell
[label Example]
curl --request GET \
     --url "https://telemetry.betterstack.com/api/v2/dashboards/1234" \
     --header "Authorization: Bearer $TOKEN"
```