Pass Templates
Webhook Subscriptions
Webhooks
Log scan
curl --request POST \
--url https://api.passentry.com/api/v1/scans/log \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"scan": {
"readerId": "south-gate-1",
"scanType": "nfc",
"status": "failed",
"statusDetail": "Membership expired",
"scanValue": "PROMO-CODE-123456",
"passId": "7882e98b-0eba-4625-9223-5221eb8dad7f",
"loyalty": {
"balance": -10
}
}
}
'{
"scanInfo": {
"scanId": "019488b8-c2fc-7b5b-b5b4-deb2b7f33bdd",
"scanType": "nfc",
"scanValue": "PROMO-CODE-123456",
"validationType": "externalValidation",
"status": "failed",
"statusDetail": "Membership expired",
"scannedAt": "2025-01-21T11:56:37Z",
"passId": "7882e98b-0eba-4625-9223-5221eb8dad7f",
"passExtId": "4312d68fd106e3e6dd15",
"readerId": "south-gate-1"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Show child attributes
Show child attributes
UUID of the reader that scanned the pass
Type of scan: nfc or barcode
nfc, barcode The raw value read by the reader during the scan
Status of the scan based on third party validation
successful, failed ID (uuid or ext_id) of the pass that was scanned
Show child attributes
Show child attributes
Detailed status message including error details
Response
OK
Show child attributes
Show child attributes
UUID of the scan
Type of scan: nfc or barcode
nfc, barcode 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.
Type of validation: 'internal' for PassEntry Validation or 'external' for Third-Party Validation.
internalValidation, externalValidation Status of the validation: 'successful' or 'failed'
successful, failed Detailed status of the validation including error details
ISO8601 timestamp of the scan
UUID of the pass that was scanned
External ID of the pass that was scanned
UUID of the reader that scanned the pass
Was this page helpful?
curl --request POST \
--url https://api.passentry.com/api/v1/scans/log \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"scan": {
"readerId": "south-gate-1",
"scanType": "nfc",
"status": "failed",
"statusDetail": "Membership expired",
"scanValue": "PROMO-CODE-123456",
"passId": "7882e98b-0eba-4625-9223-5221eb8dad7f",
"loyalty": {
"balance": -10
}
}
}
'{
"scanInfo": {
"scanId": "019488b8-c2fc-7b5b-b5b4-deb2b7f33bdd",
"scanType": "nfc",
"scanValue": "PROMO-CODE-123456",
"validationType": "externalValidation",
"status": "failed",
"statusDetail": "Membership expired",
"scannedAt": "2025-01-21T11:56:37Z",
"passId": "7882e98b-0eba-4625-9223-5221eb8dad7f",
"passExtId": "4312d68fd106e3e6dd15",
"readerId": "south-gate-1"
}
}