---
title: "List active alert rules"
method: GET
path: "/api/v1/realtime"
tags: ["realtime"]
---

# List active alert rules

`GET /api/v1/realtime`

Return all active real-time VLM alert rules.

## Query parameters

- `size` integer — Maximum number of rules to return
- `offset` integer — Number of rules to skip (for pagination)

## Response `200`

Active alert rules

- RealtimeAlertListResponse — Response for GET /api/v1/realtime.
  - `status` string
  - `rules` RealtimeAlertRule[], required
    - `id` string, required
    - `sensor_id` string, nullable — Sensor/stream ID in VIOS. Optional in responses to remain backward-compatible with legacy rule documents persisted before the field existed; for rules created or replayed by the current service it is always set.
    - `sensor_name` string, nullable
    - `description` string, nullable
    - `live_stream_url` string, required
    - `place_name` string, nullable
    - `place_type` string, nullable
    - `place_lat` string, nullable
    - `place_lon` string, nullable
    - `place_alt` string, nullable
    - `place_coordinate_x` string, nullable
    - `place_coordinate_y` string, nullable
    - `alert_type` string
    - `prompt` string, required
    - `system_prompt` string, required
    - `model` string, required
    - `chunk_duration` integer, required
    - `chunk_overlap_duration` integer, required
    - `num_frames_per_second_or_fixed_frames_chunk` integer, required
    - `use_fps_for_chunking` boolean, required
    - `vlm_input_width` integer, required
    - `vlm_input_height` integer, required
    - `enable_reasoning` boolean, required
    - `status` string
    - `created_at` string, required
    - `updated_at` string, nullable — last-update timestamp (set by Elasticsearch)
    - `api_type` string, nullable
    - `response_format` object, nullable
    - `stream_options` object, nullable
    - `max_tokens` integer, nullable
    - `temperature` number, nullable
    - `top_p` number, nullable
    - `top_k` integer, nullable
    - `ignore_eos` boolean, nullable
    - `seed` integer, nullable
    - `media_info` object, nullable
    - `enable_audio` boolean, nullable
    - `mm_processor_kwargs` object, nullable
  - `count` integer, required
  - `total` integer — Total matching rules

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/nvidia/apis/alert-agent-api.md) · [All operations](https://skmtc.dev/nvidia/apis/alert-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/alert-agent-api/revisions/e754ab3efedd/schema)