Get Loyalty Card Transaction Logs

List card's transactions

GET/v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/logs

Use it in a workflow

Add a step and choose the Talon.One connector.
Pick the Get Loyalty Card Transaction Logs action (under management).
Fill in the fields below, then reference the result from later steps as {{getLoyaltyCardTransactionLogs.response.data}}.

Request

Path parameters

loyaltyProgramIdinteger (int64)required

Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint.

loyaltyCardIdstringrequired

Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`.

Query parameters

startDatestring (date-time)

Date and time from which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.

endDatestring (date-time)

Date and time by which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.

pageSizeinteger (int64)

The number of items in the response.

Default 1000

skipinteger (int64)

The number of items to skip when paging through large result sets.

subledgerIdstring

The ID of the subledger by which we filter the data.

customerSessionIDsarray<string>

Filter the results by a list of customer session IDs. To include multiple IDs, repeat the parameter for each one, for example, `?customerSessionIDs=id1&customerSessionIDs=id2`. The response contains only data associated with the specified sessions.

transactionUUIDsarray<string>

Filter the results by a list of transaction UUIDs. To include multiple IDs, repeat the parameter for each one, for example, `?transactionUUIDs=uuid1&transactionUUIDs=uuid2`. The response contains only data associated with the specified transactions.

Response

Returns 200 with an object. Read it in later steps with {{getLoyaltyCardTransactionLogs.response.data.<field>}}.

hasMoreboolean

true means there is more data in the source collection to request..

dataarray<object>

List of loyalty card transaction logs.

transactionUUIDstringrequired

Unique identifier of the transaction in the UUID format.

createdstring (date-time)required

Date and time the loyalty card transaction occurred.

programIdinteger (int64)required

ID of the loyalty program.

cardIdentifierstringrequired

The identifier of the loyalty card, which must match the regular expression `^[A-Za-z0-9._%+@-]+$`.

applicationIdinteger (int64)

The ID of the Application that owns this entity.

sessionIdinteger (int64)

The **internal** ID of the session.

customerSessionIdstring

ID of the customer session where the transaction occurred.

typestringrequired

Type of transaction. Possible values: - `addition`: Signifies added points. - `subtraction`: Signifies deducted points.

One ofadditionsubtraction

namestringrequired

Name or reason of the loyalty ledger transaction.

startDatestringrequired

When points become active. Possible values: - `immediate`: Points are immediately active. - a timestamp value: Points become active at a given date and time.

expiryDatestringrequired

Date when points expire. Possible values are: - `unlimited`: Points have no expiration date. - `timestamp value`: Points become active from the given date.

subledgerIdstringrequired

ID of the subledger.

amountnumberrequired

Amount of loyalty points added or deducted in the transaction.

idinteger (int64)required

ID of the loyalty ledger entry.

json

{
  "hasMore": true,
  "data": [
    {
      "amount": 10.25,
      "created": {},
      "customerSessionId": "05c2da0d-48fa-4aa1-b629-898f58f1584d",
      "sessionId": 233,
      "type": "addition",
      "cardIdentifier": "summer-loyalty-card-0543",
      "expiryDate": "2022-08-02T15:04:05Z07:00",
      "transactionUUID": "ce59f12a-f53b-4014-a745-636d93f2bd3f",
      "subledgerId": "sub-123",
      "name": "Reward 10% points of a purchase's current total",
      "id": 123,
      "applicationId": 322,
      "programId": 324,
      "startDate": "2022-01-02T15:04:05Z07:00"
    }
  ]
}

Need more? See the Talon.One guide for connection setup and behaviour shared by every action.

Was this page helpful?