POST
/
api
/
v1
/
scans
curl --request POST \
  --url https://api.passentry.com/api/v1/scans \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "scan": {
    "readerId": "south-gate-1",
    "passId": "7882e98b-0eba-4625-9223-5221eb8dad7f",
    "scanType": "barcode"
  }
}'
{
  "validationResponse": {
    "status": "failed",
    "statusDetail": "Pass is not active",
    "readerInstructions": {
      "message": "Sorry, your pass is not active. Please contact the venue for assistance."
    }
  },
  "scanInfo": {
    "scanId": "019488b8-c2fc-7b5b-b5b4-deb2b7f33bdd",
    "scanType": "barcode",
    "scanValue": "7882e98b-0eba-4625-9223-5221eb8dad7f",
    "validationType": "internalValidation",
    "status": "failed",
    "statusDetail": "Pass is not active",
    "scannedAt": "2025-01-21T11:56:37Z",
    "passId": "7882e98b-0eba-4625-9223-5221eb8dad7f",
    "passExtId": "4312d68fd106e3e6dd15",
    "readerId": "south-gate-1"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
scan
object

Response

200
application/json
OK
validationResponse
object
scanInfo
object

Was this page helpful?