---
method: GET
path: /api/scanner/watch/status
auth: jwt+admin
area: scanner
---
<!-- source: internal/handlers/scanner.go:376 Handler.GetWatchModeStatus -->

# Get Watch Mode Status

Get the watch mode status for a library.

**Endpoint**: `GET /api/scanner/watch/status`
**Auth**: Required (Admin only)

## Query Parameters

| Parameter  | Type          | Required | Description           |
| ---------- | ------------- | -------- | --------------------- |
| library_id | string (UUID) | Yes      | Library UUID to check |

## Request Headers

| Header        | Type   | Required | Description                         |
| ------------- | ------ | -------- | ----------------------------------- |
| Authorization | string | Yes      | Bearer token (must have admin role) |

### Example Request

```http
GET /api/scanner/watch/status?library_id=550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```

## Response (200 OK)

```json example-response
{
  "total_watching": null,
  "watching_libraries": null
}
```

## Status Values

| Status   | Description                     |
| -------- | ------------------------------- |
| watching | Watch mode is active            |
| stopped  | Watch mode is not active        |
| error    | Watch mode encountered an error |

## Error Responses

| Code | Description                         |
| ---- | ----------------------------------- |
| 400  | Missing library_id parameter        |
| 401  | Invalid or expired token            |
| 403  | User does not have admin privileges |
| 404  | Library not found                   |