---
title: "Log scan"
method: POST
path: "/api/v1/scans/log"
tags: ["Scans"]
---

# Log scan

`POST /api/v1/scans/log`

## Request body

- LogScan
  - `scan` LogScanAttributes
    - `readerId` string, required — UUID of the reader that scanned the pass
    - `passId` string — ID (uuid or ext_id) of the pass that was scanned
    - `scanType` 'nfc' | 'barcode', required — Type of scan: nfc or barcode
    - `loyalty` object
      - `balance` number — Balance to add or redeem. Can't be used together with balanceOverride.
      - `balanceOverride` number — Balance to override the pass balance with. Can't be used together with balance.
      - `message` string — Notification message to send after the operation
    - `scanValue` string, required — The raw value read by the reader during the scan
    - `status` 'successful' | 'failed', required — Status of the scan based on third party validation
    - `statusDetail` string — Detailed status message including error details

## Response `200`

OK

- ExternalValidationResponse
  - `scanInfo` ScanInfo
    - `scanId` string — UUID of the scan
    - `scanType` 'nfc' | 'barcode' — Type of scan: nfc or barcode
    - `scanValue` string — The raw value read by the reader during the scan. For NFC, this is the encoded NFC message. For barcodes, this is the encoded barcode value.
    - `validationType` 'internalValidation' | 'externalValidation' — Type of validation: 'internal' for PassEntry Validation or 'external' for Third-Party Validation.
    - `status` 'successful' | 'failed' — Status of the validation: 'successful' or 'failed'
    - `statusDetail` string — Detailed status of the validation including error details
    - `scannedAt` string — ISO8601 timestamp of the scan
    - `passId` string — UUID of the pass that was scanned
    - `passExtId` string — External ID of the pass that was scanned
    - `readerId` string — UUID of the reader that scanned the pass

## Other responses

- `401` — Error: Unauthorized
- `422` — Error: Unprocessable Entity

---

[API](https://skmtc.dev/passentry/apis/passentry-api.md) · [All operations](https://skmtc.dev/passentry/apis/passentry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/passentry/passentry-api/revisions/3b24e067f9d9/schema)