get_watch_events

Retrieve events detected by monitoring watches. Events include status changes, similar filings, and approaching deadlines. Filter by watch ID, severity, and acknowledgement status.

Parameters

Parameter	Type	Required	Description
watchId	string	No	Filter events by watch ID. Omit to get events from all watches.
severity	string	No	Filter by severity: info, warning, or critical
unacknowledgedOnly	boolean	No	Only return unread events (default: false)
limit	number	No	Maximum events to return (default: 20, max: 100)

Example

Request

{
  "name": "get_watch_events",
  "arguments": {
    "unacknowledgedOnly": true,
    "severity": "critical",
    "limit": 10
  }
}

Response

{
  "events": [
    {
      "id": "evt_12345",
      "watchId": "w_abc123def456",
      "type": "status_change",
      "severity": "critical",
      "detectedAt": "2024-03-04T09:15:00.000Z",
      "summary": "NEXTERA (EU-018734521) status changed from \"registered\" to \"cancellation_pending\"",
      "details": {
        "trademarkId": "EU-018734521",
        "trademarkName": "NEXTERA",
        "jurisdiction": "EU",
        "previousStatus": "registered",
        "newStatus": "cancellation_pending",
        "statusDate": "2024-03-04"
      },
      "acknowledged": false,
      "webhookDelivered": true
    },
    {
      "id": "evt_12346",
      "watchId": "w_def456ghi789",
      "type": "similar_filing",
      "severity": "critical",
      "detectedAt": "2024-03-03T14:20:00.000Z",
      "summary": "New similar filing \"NEXTERRA\" detected in US (92% similarity)",
      "details": {
        "monitoredMark": "NEXTERA",
        "similarMark": "NEXTERRA",
        "similarMarkId": "US-98765432",
        "jurisdiction": "US",
        "similarityScore": 0.92,
        "conflictType": "visual",
        "filingDate": "2024-03-01",
        "owner": "Nexterra Solutions LLC",
        "overlappingClasses": [9, 42]
      },
      "acknowledged": false,
      "webhookDelivered": false
    }
  ],
  "total": 2,
  "summary": "Found 2 event(s)."
}

Notes

• Event severity: critical for status changes that threaten the mark, exact conflicts, and imminent deadlines. warning for phonetic/visual conflicts and upcoming deadlines. info for routine status updates.
• Events remain in the system until acknowledged via acknowledge_events.
• The details object structure varies by event type (see StatusChangeDetails, SimilarFilingDetails, DeadlineDetails).

Related Tools

• acknowledge_events — mark events as read
• list_watches — find watch IDs
• portfolio_analytics — aggregate alert summary