Loyalty Activity Log API

Overview

Returns the visit history for a loyalty member — every Progress Update recorded against their pass, most recent first. Use it to audit how a member's stamp / points count changed over time.

Base URL

https://app.addtowallet.co

GET/api/loyalty-pass/activity-log/:customerId

Path Parameters

customerId (string, required): The member whose activity you want. This is the customerId from Add User / List Users.

Authentication

All API requests must include your API key in the request headers:

"apikey": "your-api-key-here"

Request Example

curl 'https://app.addtowallet.co/api/loyalty-pass/activity-log/686d10e7c2f0bc5cdf25c84b' \
  -H 'apikey: your-api-key-here'

Response

Returns the list of activity entries in data:

Top-Level Fields

message (string): Status message.
status (boolean): True on success.
data (array): Activity entries, newest first.

Activity Entry Fields

customerId (string): The member.
passCardId (string): The member's pass.
issuerId, userId (string): Who recorded the check-in.
timestamp (ISO date): When it happened.
action (object): type (e.g. visit_updated), operation (increased | decreased | reset), and a human-readable msg.

Response Example

{
  "message": "Fetched logs successfully",
  "status": true,
  "data": [
    {
      "customerId": "686d10e7c2f0bc5cdf25c84b",
      "passCardId": "686d10e7c2f0bc5cdf25c84e",
      "issuerId": "66b6005bb7bddce8f05a3380",
      "userId": "66b6005bb7bddce8f05a3381",
      "timestamp": "2026-03-20T14:22:03.000Z",
      "action": {
        "type": "visit_updated",
        "operation": "increased",
        "msg": "Updated visit count from 2 to 3"
      }
    },
    {
      "customerId": "686d10e7c2f0bc5cdf25c84b",
      "passCardId": "686d10e7c2f0bc5cdf25c84e",
      "issuerId": "66b6005bb7bddce8f05a3380",
      "userId": "66b6005bb7bddce8f05a3381",
      "timestamp": "2026-03-18T09:10:00.000Z",
      "action": {
        "type": "visit_updated",
        "operation": "increased",
        "msg": "Updated visit count from 1 to 2"
      }
    }
  ]
}

Error Code	Description
400	Bad Request - Missing customerId.
401	Unauthorized - Missing or invalid API key.
404	Not Found - No logs found for this customer.
429	Too Many Requests - API rate limit exceeded. Please wait before making additional requests.
500	Internal Server Error - Unexpected error retrieving logs. Please contact support.