---
title: "List card's transactions (Management API)"
method: GET
path: "/v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/logs"
tags: ["Loyalty cards"]
---

# List card's transactions (Management API)

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

## Request

- Base URL: `https://yourbaseurl.talon.one`
- URL: `https://yourbaseurl.talon.one/v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/logs`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/talon/apis/management-api/docs/v1/loyalty_programs/:loyaltyProgramId/cards/:loyaltyCardId/logs/get.ts> (a function with typed inputs; its response is checked against the schema)

> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Retrieve the transaction logs for the given [loyalty card](https://docs.talon.one/docs/product/loyalty-programs/card-based/card-based-overview)
within the specified [card-based loyalty program](https://docs.talon.one/docs/product/loyalty-programs/overview#loyalty-program-types)
with filtering options applied.

> [!note] For most use cases, especially real-time integrations, use the Integration API endpoint:
> [List card's transactions](https://docs.talon.one/integration-api#tag/Loyalty-cards/operation/getLoyaltyCardTransactions).

If no filtering options are applied, the last 50 loyalty transactions for
the given loyalty card are returned.

## Path parameters

- `loyaltyProgramId` integer, required
- `loyaltyCardId` string, required

## Query parameters

- `startDate` string, date-time
- `endDate` string, date-time
- `pageSize` integer
- `skip` integer
- `subledgerId` string
- `customerSessionIDs` string[]
- `transactionUUIDs` string[]

## Response `200`

OK

- object
  - `hasMore` boolean, required: true means there is more data in the source collection to request..
  - `data` CardLedgerTransactionLogEntry[], required: List of loyalty card transaction logs.
    - `transactionUUID` string, required: Unique identifier of the transaction in the UUID format.
    - `created` string, date-time, required: Date and time the loyalty card transaction occurred.
    - `programId` integer, required: ID of the loyalty program.
    - `cardIdentifier` string, required: The identifier of the loyalty card, which must match the regular expression `^[A-Za-z0-9._%+@-]+$`.
    - `applicationId` integer: The ID of the Application that owns this entity.
    - `sessionId` integer: The **internal** ID of the session.
    - `customerSessionId` string: ID of the customer session where the transaction occurred.
    - `type` 'addition' | 'subtraction', required: Type of transaction. Possible values: - `addition`: Signifies added points. - `subtraction`: Signifies deducted points.
    - `name` string, required: Name or reason of the loyalty ledger transaction.
    - `startDate` string, required: When points become active. Possible values: - `immediate`: Points are immediately active. - a timestamp value: Points become active at a given date and time.
    - `expiryDate` string, required: Date when points expire. Possible values are: - `unlimited`: Points have no expiration date. - `timestamp value`: Points become active from the given date.
    - `subledgerId` string, required: ID of the subledger.
    - `amount` number, required: Amount of loyalty points added or deducted in the transaction.
    - `id` integer, required: ID of the loyalty ledger entry.

## Other responses

- `401`: Unauthorized
- `404`: Not found

---

[API](https://skmtc.dev/talon/apis/management-api.md) - [All operations](https://skmtc.dev/talon/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/talon/apis/management-api/revisions/7ef1b9504c3a?raw)