Transactions

Query verification transactions recorded by your tenant's devices. All transactions are read-only — they are created automatically by the verification endpoints.

Note: Transaction records are immutable. No party can create or modify transactions through this endpoint. The encrypted auditBlob is never included in API responses — it can only be decrypted by regulatory authorities.

GET/api/v1/transactions

List transactions for your tenant, sorted by createdAt descending. Supports filtering and pagination.

Headers

Name	Type	Required	Description
Authorization	string	Required	Bearer <access_token> — requires transactions:read scope

AuthorizationstringRequired

Bearer <access_token> — requires transactions:read scope

Query Parameters

Name	Type	Required	Description
deviceId	string	Optional	Filter by the device the transaction is attributed to
verifiedBy	string	Optional	Filter by employee ID (manual verifications)
verifyType	string	Optional	Filter by verification method: "pass" \| "eID" \| "manual"
locationId	string	Optional	Filter by location
result	string	Optional	Filter by result: "pass" \| "fail"
posReference	string	Optional	Filter by the posReference supplied at verification time
fromDate	string	Optional	ISO 8601 date — return transactions on or after this date
toDate	string	Optional	ISO 8601 date — return transactions on or before this date
limit	number	Optional	Page size. When provided, the response includes nextCursor and hasMore
cursor	string	Optional	Pagination cursor from a previous response

deviceIdstringOptional

Filter by the device the transaction is attributed to

verifiedBystringOptional

Filter by employee ID (manual verifications)

verifyTypestringOptional

Filter by verification method: "pass" | "eID" | "manual"

locationIdstringOptional

Filter by location

resultstringOptional

Filter by result: "pass" | "fail"

posReferencestringOptional

Filter by the posReference supplied at verification time

fromDatestringOptional

ISO 8601 date — return transactions on or after this date

toDatestringOptional

ISO 8601 date — return transactions on or before this date

limitnumberOptional

Page size. When provided, the response includes nextCursor and hasMore

cursorstringOptional

Pagination cursor from a previous response

Response

{
  "data": [
    {
      "id": "j57b2mNkR4e9...",
      "deviceId": "dev_abc123",
      "challengeType": "age",
      "challengeData": { "requiredAge": 18 },
      "verifiedBy": null,
      "verifyType": "pass",
      "ephemeralId": "eph_001",
      "result": "pass",
      "posReference": "till-4-receipt-1234",
      "locationId": "loc_xyz",
      "createdAt": "2024-01-15T10:00:00.000Z"
    }
  ]
}

Transaction Fields

Field	Type	Description
id	string	Unique transaction identifier
deviceId	string \| null	Device the transaction is attributed to; null if none
challengeType	string	Type of challenge: "age"
challengeData	object	Challenge parameters (e.g. { "requiredAge": 18 })
verifiedBy	string \| null	Employee ID for manual verifications; null otherwise
verifyType	string	Verification method used: "pass" \| "eID" \| "manual"
ephemeralId	string	Ephemeral identifier for the customer (pass verifications)
result	string	"pass" \| "fail"
failReason	string \| null	Reason for a failed verification, when available
posReference	string	Your own reference supplied at verification time (receipt/basket ID)
locationId	string	Location where the transaction occurred
createdAt	string	ISO 8601 timestamp