# List all dashboard sections

Retrieves a list of all sections on a specific dashboard. This endpoint is not paginated; it returns all sections for a given dashboard in a single response.

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

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

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

[responses]
[[response]]
status = 200
description = "A list of sections for the specified dashboard."
body = '''
{
  "data": [
    {
      "id": "890",
      "type": "section",
      "attributes": {
        "name": "Key Metrics",
        "y": 0,
        "collapsed": false
      }
    }
  ]
}
'''

[[response]]
status = 404
description = "A dashboard with the specified ID was not found."
[/responses]

## Example request

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