---
method: GET
path: /api/dashboard/sections
auth: jwt
area: dashboard
---
<!-- source: internal/handlers/dashboard.go:28 DashboardHandler.GetSections -->

# Get Dashboard Sections

Returns all dashboard sections for a library, in the user's customized order.
Respects `collection_order` and `hidden_collections` preferences. `library_id`
is optional; when omitted the global (all-libraries) scope is used.

## Example response

```json example-response
{
  "sections": [
    {
      "id": "continue-reading",
      "collection_id": "",
      "is_system": true,
      "title": "Continue Reading",
      "description": "Books you're currently reading (0 < progress < 1)",
      "icon": "📖",
      "items": [],
      "view_all_url": "",
      "priority": 1,
      "is_playlist": false,
      "complete": false
    }
  ]
}
```

## Query parameters

| Param | Type | Required | Notes |
| ----- | ---- | -------- | ----- |
| library_id | uuid | No | Library to scope sections to |
| limit | int | No | Items per section (1-100, default from preferences) |

## Errors

| Status | Body | When |
| ------ | ---- | ---- |
| 400 | `{"error": "invalid library_id"}` | malformed library_id |
| 500 | `{"error": "Failed to load dashboard sections"}` | unexpected server error |