---
method: GET
path: /api/libraries/scan-settings
auth: jwt+admin
area: libraries
---
<!-- source: internal/handlers/system_settings.go:253 SystemSettingsHandler.GetScanSettings -->

# Get Scan Settings

Returns the global scan poll interval and auto-scan flag (system settings,
admin-scoped). Defaults to 1800s / enabled when unset.

## Example response

```json example-response
{
  "scan_poll_interval_seconds": 1800,
  "auto_scan_enabled": true
}
```

`message` appears only in the update response (`omitempty`).

## Errors

| Status | Body | When |
| ------ | ---- | ---- |
| 401 / 403 | — | missing JWT / not an admin |
| 500 | `{"error": "..."}` | unexpected server error |