# alert.acknowledged

Canonical page: https://docs.ovok.com/signals/standalone/webhooks/alert-acknowledged

Someone acknowledges the alert for the first time. Acknowledging it again sends nothing.

## Payload [#payload]

Every delivery is the envelope `type`, `timestamp`, `sequence` and `data`; the delivery's id is the `webhook-id` header. See [Verify webhooks](/signals/standalone/verify-webhooks).

```json
{
  "type": "alert.acknowledged",
  "timestamp": "2026-10-25T08:00:02.000Z",
  "sequence": 1045,
  "data": {
    "id": "0b9d7e52-1f3a-4e8c-b6a2-7c4d9e1f2a35",
    "patient": "6f1c2a8e-3b7d-4c55-9a0e-2d4b8f6e1a90",
    "observation": "a3e8f1c2-5d6b-4a7e-9c0f-1b2d3e4f5a6b",
    "observationObservedAt": "2026-10-25T08:00:00.000Z",
    "component": {
      "code": {
        "coding": [
          {
            "code": "8867-4",
            "system": "http://loinc.org"
          }
        ]
      },
      "valueQuantity": {
        "value": 132,
        "unit": "/min"
      }
    },
    "triggerCode": "8867-4",
    "triggerVersion": 1,
    "value": 132,
    "message": "Heart rate above 110 /min",
    "reason": "trigger",
    "createdAt": "2026-10-25T08:00:02.000Z",
    "updatedAt": "2026-10-25T08:05:00.000Z",
    "effectiveTS": "2026-10-25T08:00:00.000Z",
    "observationRefId": "reading-0001",
    "derivedObservation": null,
    "patientRefId": "resident-001",
    "episodeId": "e7a1b2c3-d4e5-4f60-8a9b-0c1d2e3f4a5b",
    "acknowledgedAt": "2026-10-25T08:05:00.000Z",
    "acknowledgedBy": {
      "reference": "Practitioner/123",
      "display": "Dr. Max Mustermann"
    },
    "version": 3
  }
}
```

The `data` fields are those of [`alert.triggered`](/signals/standalone/webhooks/alert-triggered#payload). `acknowledgedBy` is the actor the acknowledging call named, or `null` when it named none.

## Handle the event [#handle-the-event]

Verify the delivery first ([Verify webhooks](/signals/standalone/verify-webhooks)), then act on the verified event as in [Handle an event](/signals/standalone/webhooks#handle-an-event).

<Tabs items={["Node.js", "Python", "Java"]} groupId="language" persist>
<Tab value="Node.js">

```js title="alert-acknowledged.js"
export async function handle(webhookId, event) {
  if (!(await firstTime(webhookId))) return;
  const { data } = event;
  switch (event.type) {
    case 'alert.acknowledged':
      await markAcknowledged(data.id, data.acknowledgedBy, data.version);
      break;
    default:
      break;
  }
}
```

</Tab>
<Tab value="Python">

```python title="alert_acknowledged.py"
def handle(webhook_id: str, event: dict) -> None:
    if not first_time(webhook_id):
        return
    data = event["data"]
    match event["type"]:
        case "alert.acknowledged":
            mark_acknowledged(data["id"], data["acknowledgedBy"], data["version"])
```

</Tab>
<Tab value="Java">

```java title="AlertAcknowledgedHandler.java"
void handle(String webhookId, JsonNode event) {
  if (!firstTime(webhookId)) return;
  JsonNode data = event.get("data");
  switch (event.get("type").asText()) {
    case "alert.acknowledged" -> {
      markAcknowledged(data.get("id").asText(), data.get("acknowledgedBy"), data.get("version").asInt());
    }
    default -> {}
  }
}
```

</Tab>
</Tabs>

## Related [#related]

- [Webhooks basics](/signals/standalone/webhooks)
- [Verify webhooks](/signals/standalone/verify-webhooks)
