---
title: "Scan event"
method: POST
path: "scan"
tags: ["Analytics"]
---

# Scan event

`POST scan` (webhook)

Sent to your webhook URL (Business Plus) on every scan of a dynamic QR code or short link. Verify `x-signature` against your webhook secret before processing.

## Headers

- `x-signature` string, required

## Payload

- Activity: One tracked scan/click.
  - `qr_code_id` string, uuid, nullable
  - `time_utc` string
  - `time_timezone_aware` string
  - `location` string, nullable
  - `device` string, nullable
  - `scanner_id` string, nullable: Hashed, anonymous scanner fingerprint.
  - `id` string, uuid

## Acknowledgement `200`

Return any 2xx to acknowledge.

---

[API](https://skmtc.dev/hovercode/apis/hovercode-api.md) · [All operations](https://skmtc.dev/hovercode/apis/hovercode-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hovercode/apis/hovercode-api/revisions/4a9bc3cafe41?raw)