> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/roboflow/roboflow-hi/deploy/vision-events/query-events.md).

# Events Query करें

## Events को Query और Filter करें

Vision Events dashboard में filters का उपयोग करके specific events खोजें, या REST API के माध्यम से programmatically उन्हें query करें।

### Dashboard में Events ब्राउज़ करें

#### एक Use Case चुनें

Vision Events पेज से, उसके events देखने के लिए किसी Use Case पर क्लिक करें। Events उल्टे कालानुक्रमिक क्रम में प्रदर्शित होते हैं।

<figure><img src="/files/22f604b1c519b9af970177b9aca1a2a2c44b4484" alt="" width="375"><figcaption></figcaption></figure>

#### Events फ़िल्टर करें

परिणामों को सीमित करने के लिए events list के ऊपर दिए filter controls का उपयोग करें:

* **दिनांक सीमा** — प्रारंभ और समाप्ति timestamps
* **Event type** — quality\_check, inventory\_count, safety\_alert, custom, operator\_feedback
* **Device** — device ID के आधार पर filter करें
* **Stream** — stream या camera ID के आधार पर filter करें
* **Workflow** — उस workflow के आधार पर filter करें जिसने events उत्पन्न किए
* **Detection** — एक detected object class के आधार पर filter करें, वैकल्पिक confidence threshold के साथ
* **Feedback status** — correct, incorrect, inconclusive, या no feedback
* **Custom metadata** — किसी भी custom metadata field और value के आधार पर filter करें
* **Warnings** — केवल वे events दिखाएँ जिनमें ingestion warnings थीं

आप event detail sidebar में values (जैसे device ID, stream, quality check result, या custom metadata values) पर भी click करके उन्हें जल्दी से filters के रूप में जोड़ सकते हैं।

Filter chips editable हैं — किसी भी active filter chip पर click करके उसकी value या operator को remove और फिर से add किए बिना संशोधित करें।

जब filters लागू होते हैं, एक **कुल संख्या** मेल खाने वाले events की results list के शीर्ष पर प्रदर्शित होती है। यह count event list से स्वतंत्र रूप से अपडेट होता है, इसलिए आप देख सकते हैं कि आपके filters से कितने events match करते हैं, भले ही events अभी लोड हो रहे हों।

<figure><img src="/files/69717c370783c4593107a89fc2bcbd9e614270ea" alt="" width="375"><figcaption></figcaption></figure>

#### Event Details देखें

अपनी पूरी details देखने के लिए list में किसी भी event पर click करें:

* Source image और कोई भी output images
* सभी source metadata (device, stream, workflow)
* Object detections, classifications, और segmentations उनके confidence scores के साथ
* Event-type-specific data (उदा.: pass/fail result, item count, alert severity)
* Custom metadata key-value pairs

**Draw Detections**

जब किसी event में prediction data (object detections, instance segmentations, या keypoints) होता है, तो image के ऊपर "Draw Detections" checkbox दिखाई देता है। इसे सक्षम करें ताकि source image के ऊपर bounding boxes, segmentation polygons, और confidence scores सहित labels overlay हो सकें।

यह तब उपयोगी है जब आपका pipeline केवल original input image को store करता है और आप separate output image को store किए बिना यह visualize करना चाहते हैं कि model ने क्या detect किया।

{% hint style="info" %}
जब distinct output image देख रहे हों, तब checkbox hidden रहता है, क्योंकि उनमें detections पहले से render होते हैं।
{% endhint %}

**Auto-Finalized Events**

Auto-finalized के रूप में flagged event video upload पूरा होने से पहले edge device पर automatically close कर दिया गया था, इसलिए video missing है। event में फिर भी इसका result और still images शामिल हैं। event card एक indicator दिखाता है, और detail view वह समय दिखाता है जब इसे finalized किया गया था। यह केवल इनके माध्यम से synced events पर लागू होता है [Edge Device Backup](/roboflow/roboflow-hi/deploy/vision-events/send-events.md#edge-device-backup).

### API के माध्यम से Events query करें

query endpoint dashboard के समान filters, साथ ही cursor-based pagination, का समर्थन करता है। parameters और response fields की पूरी सूची के लिए देखें [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events).

#### Basic Query

```bash
curl -X POST "https://api.roboflow.com/vision-events/query" \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -d '{
    "useCaseId": "assembly-line-qa",
    "startTime": "2026-03-01T00:00:00Z",
    "endTime": "2026-03-31T23:59:59Z",
    "limit": 25
  }'
```

**प्रतिक्रिया:**

```json
{
  "events": [
    {
      "eventId": "evt-789ghi",
      "eventType": "quality_check",
      "timestamp": "2026-03-30T14:30:00.000Z",
      "deviceId": "factory-cam-01",
      "streamId": "line-3",
      "images": [],
      "eventData": { "result": "fail" },
      "customMetadata": {
        "line_id": "line-3",
        "shift": "morning",
        "part_number": "PN-4421"
      }
    }
  ],
  "nextCursor": "eyJ0cyI6IjIwMjYtMDMtMzAifQ==",
  "hasMore": true
}
```

#### पृष्ठांकन

परिणामों को cursor का उपयोग करके paginated किया जाता है। यदि response में एक `nextCursor` मान और `hasMore` है `true`हो, तो अगले page को retrieve करने के लिए अपनी अगली request में cursor पास करें:

```bash
curl -X POST "https://api.roboflow.com/vision-events/query" \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -d '{
    "useCaseId": "assembly-line-qa",
    "limit": 25,
    "cursor": "eyJ0cyI6IjIwMjYtMDMtMzAifQ=="
  }'
```

जारी रखें जब तक `hasMore` है `false`.

#### Event Type के आधार पर filter करें

एक single event type query करें:

```json
{
  "useCaseId": "assembly-line-qa",
  "eventType": "quality_check"
}
```

या कई event types (अधिकतम 20):

```json
{
  "useCaseId": "assembly-line-qa",
  "eventTypes": ["quality_check", "operator_feedback"]
}
```

#### Feedback Status के आधार पर filter करें

उपयोग करें `feedbackStatus` को यह जानने के लिए कि operators ने उन्हें review किया है या नहीं और उन्हें कैसे rate किया गया है:

```json
{
  "useCaseId": "assembly-line-qa",
  "feedbackStatus": ["incorrect", "none"]
}
```

मान्य मान: `correct`, `incorrect`, `inconclusive`, `none`का उपयोग करें `none` उन events को खोजने के लिए जिन्होंने अभी तक review नहीं किया गया है।

#### Custom Metadata के आधार पर filter करें

उपयोग करें `customMetadataFilters` का उपयोग करके अपने metadata fields के आधार पर events filter करें:

```json
{
  "useCaseId": "assembly-line-qa",
  "customMetadataFilters": [
    { "key": "line_id", "operator": "eq", "value": "line-3" },
    { "key": "shift", "operator": "eq", "value": "morning" }
  ]
}
```