---
method: GET
path: /api/system/settings
auth: jwt+admin
area: system
---
<!-- source: internal/handlers/system_settings.go:44 SystemSettingsHandler.GetSettings -->

# Get System Settings

Returns metadata and current values for every known tunable system setting.

## Example response

```json example-response
[
  {
    "key": "scan_poll_interval_seconds",
    "value": "60",
    "type": "int",
    "requires_restart": false,
    "category": "scanner",
    "group": "Scanning",
    "description": "How often to scan all libraries (seconds)",
    "is_default": true
  }
]
```

## Errors

| Status | Body | When |
| ------ | ---- | ---- |
| 503 | `{"error": "settings registry not initialized"}` | registry not wired |