---
title: "Get a single alert rule"
method: GET
path: "/api/v1/realtime/{alert_rule_id}"
tags: ["realtime"]
---

# Get a single alert rule

`GET /api/v1/realtime/{alert_rule_id}`

Retrieve a single real-time VLM alert rule by ID. Reads from Elasticsearch when persistence is enabled, otherwise from the in-memory registry.

## Path parameters

- `alert_rule_id` string, uuid, required

## Response `200`

Alert rule

- RealtimeAlertGetResponse — Response for GET /api/v1/realtime/{alert_rule_id}.
  - `status` string
  - `rule` RealtimeAlertRule, required — Representation of a single active realtime alert rule.
    - `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

## Other responses

- `404` — Alert rule not found (`not_found`).
- `422` — Invalid UUID format
- `502` — Elasticsearch query failed (`elasticsearch_query_failed`).

---

[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)