Get Wallet Activity

Overview

Returns paginated recent activity for the authenticated member's wallet, including point earnings, redemptions, transfers, and adjustments.

This endpoint provides a user-friendly activity feed for displaying in member-facing applications.

Authentication

Requires a valid Clerk JWT token in the Authorization header.

Query Parameters

limitquerynumber

Maximum number of activities to return (default: 20, max: 100)

offsetquerynumber

Number of activities to skip for pagination (default: 0)

activityTypequerystring

Filter by activity type

Allowed values: "earn", "spend", "transfer", "adjustment"

fromquerystring

Start date for filtering activities (ISO 8601 format)

Example: "2024-01-01T00:00:00Z"

toquerystring

End date for filtering activities (ISO 8601 format)

Example: "2024-12-31T23:59:59Z"

Request

curl -X GET "http://localhost:3000/v1/members/me/wallet/activity?limit=10&activityType=earn" \
  -H "Authorization: Bearer YOUR_CLERK_JWT"

Response

itemsarrayrequired

List of activity items

array items

idstringrequired

Activity ID

typestringrequired

Activity type: "earn", "spend", "transfer", "adjustment"

amountnumberrequired

Point amount (positive for credits, negative for debits)

assetTypestringrequired

Asset type: "VALID" or "CREDIT"

descriptionstringrequired

Human-readable description of the activity

sourceTypestring

Source of the activity: "reservation", "transfer", "offer", "adjustment", etc.

sourceIdstring

ID of the source entity (reservation ID, transfer ID, etc.)

propertyNamestring

Property name for reservation-related activities

reservationConfirmationCodestring

Confirmation code for reservation-related activities

createdAtstringrequired

ISO 8601 timestamp when activity occurred

statusstringrequired

Activity status: "completed", "pending", "failed", "cancelled"

totalnumberrequired

Total number of activities matching the filters

offsetnumberrequired

Current pagination offset

limitnumberrequired

Current pagination limit

Response

200 Response

{
  "items": [
    {
      "id": "activity_123",
      "type": "earn",
      "amount": 2500,
      "assetType": "VALID",
      "description": "Points earned from stay at Luxury Resort & Spa",
      "sourceType": "reservation",
      "sourceId": "12345",
      "propertyName": "Luxury Resort & Spa",
      "reservationConfirmationCode": "ABC123",
      "createdAt": "2024-04-15T14:30:00Z",
      "status": "completed"
    },
    {
      "id": "activity_124",
      "type": "spend",
      "amount": -1000,
      "assetType": "VALID",
      "description": "Redeemed: Suite Upgrade at Downtown Hotel",
      "sourceType": "offer",
      "sourceId": "offer_456",
      "propertyName": "Downtown Hotel",
      "createdAt": "2024-04-10T09:15:00Z",
      "status": "completed"
    },
    {
      "id": "activity_125",
      "type": "transfer",
      "amount": 500,
      "assetType": "VALID",
      "description": "Received transfer from Jane Doe",
      "sourceType": "transfer",
      "sourceId": "transfer_789",
      "createdAt": "2024-04-05T16:45:00Z",
      "status": "completed"
    },
    {
      "id": "activity_126",
      "type": "adjustment",
      "amount": 250,
      "assetType": "CREDIT",
      "description": "Welcome bonus - new member",
      "sourceType": "adjustment",
      "sourceId": "adj_012",
      "createdAt": "2024-04-01T10:00:00Z",
      "status": "completed"
    }
  ],
  "total": 47,
  "offset": 0,
  "limit": 10
}