> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Voucher tracking

> Track voucher activity and transactions for gift and loyalty cards

Open a voucher's detail view to see how it's used and managed."

The detailed view of a voucher shows its:

* Details, like its parent campaign, voucher owner, and info specific to the voucher type.
* Voucherify ID.
* Barcode and QR code.
* Redemption overview.

From the detailed view, you can go to other tabs to track voucher usage, check any failures, and use the data to debug errors.

## Find vouchers

Use the **Vouchers** view to browse and search all voucher types in one place.

Go to **Campaign Hub** > **Campaigns** > **Vouchers** to see all your codes, including:

* Discount coupons
* Gift cards
* Referral codes
* Loyalty cards

Use filters to narrow down the list of vouchers based on selected criteria.

You can also use **Search codes** on the left bar to find a voucher by its code.

### Use categories

Use **Categories** to organize vouchers and filter them faster.

You can create a category when you create a campaign or add it later in the voucher details. To manage categories, go to **Campaigns** > **Categories**.

Categories can also have a hierarchy. The lower the number, the higher the category priority in stacking rules.

## Redemptions and validations

The **Redemptions** and **Validations** tabs list successful and unsuccessful redemption and validation attempts.

**Add filter** to narrow down results.

Click on ID to learn more about the event, access its log, and request and response payloads.

You can also export redemption data to a CSV file.

<Info>
  Validation data is stored for 30 days.

  **Logs** are stored for a limited time:

  * Shared clusters: 6 months
  * Dedicated clusters: 12 months
</Info>

## Voucher activity

The **Activity** tab lists all events related to the voucher, like creation, updates, or deactivation.

**Add filter** to narrow down results.

Click **Log** to learn more about the event, see related events, and request and response payloads.

<Tip>
  <Badge color="green">Solving issues with vouchers</Badge>

  The **Activity** tab in voucher details is a great tool for solving issues you have with voucher configuration, validation, and redemption. The events listed contain all data regarding changes to the campaign as well as the API request and response payloads of those changes.
</Tip>

## Track gift and loyalty card transactions

In the detailed view of a gift or loyalty card, use the **Transactions** tab to monitor balance changes.

The **Transactions** tab lists:

* Transaction type: For example, point or credit redemption.
* Balance: Current number of points or credits
* Creation date: When the transaction occurred.
* Transaction details (**+** button), which show the transaction in a JSON format.

## Export for data tracking

Use exports to download voucher and transaction data for reporting.

The export tool looks similar for all exports.

<Steps>
  <Step title="Select attributes">
    Choose which standard fields and custom attributes (metadata) to include in the exported CSV.

    The date and times of the exported data are in the UTC time zone.
  </Step>

  <Step title="Export">
    Once ready, **Export** your list. The file will be generated and delivered to your **Notifications Center**.

    You can also find all your exported files in **Audit log** > **Exports**.

    <Note>
      Larger exports may take longer to generate.
    </Note>
  </Step>
</Steps>

### Export vouchers

Export voucher data to review or analyze voucher usage.

To export all or filtered vouchers:

1. Go to **Vouchers**.
2. Apply filters (optional).
3. Click **Manage filtered vouchers**.
4. Click **Export filtered vouchers**.

You can also export vouchers by going to a campaign and clicking the three-dot **⋮** menu > **Export to CSV**. This exports all vouchers, even if filters are applied.

### Export transactions

Export transactions directly from the **Transactions** tab.

Click **Export**, then choose which fields to include in the CSV file.

<AccordionGroup>
  <Accordion title="Gift cards: Available export fields">
    You can export the following fields for gift card transactions:

    * ID: Unique Voucherify transaction ID.
    * Type: Type of the transaction, for example `CREDITS_ADDITION`.
    * Source ID: Optional source ID of the transaction.
    * Reason: Optional reason added to the transaction.
    * Balance: The number of available credits after the transaction.
    * Amount: The number of credits added or subtracted in the transaction.
    * Creation date: The date and time when the transaction was created (in UTC time zone).
    * Voucher ID: Unique Voucherify ID of the gift card.
    * Campaign ID: Unique Voucherify ID of the parent campaign.
    * Source: The origin of the transaction, for example Voucherify web UI.
    * Details: JSON payload of the transaction details.
  </Accordion>

  <Accordion title="Loyalty cards: Available export fields">
    You can export the following fields for loyalty card transactions:

    * ID: Unique Voucherify transaction ID.
    * Type: Type of the transaction, for example `POINTS_ACCRUAL`.
    * Source ID: Optional source ID of the transaction.
    * Reason: Optional reason added to the transaction.
    * Balance: The number of available points after the transaction.
    * Amount: The number of points added or subtracted in the transaction.
    * Creation date: The date and time when the transaction was created (in UTC time zone).
    * Voucher ID: Unique Voucherify ID of the loyalty card.
    * Campaign ID: Unique Voucherify ID of the parent campaign.
    * Source: The origin of the transaction, for example Voucherify web UI.
    * Details: JSON payload of the transaction details.
    * Related transaction ID: Unique Voucherify transaction ID related to a receiver/donor card when points were transferred from/to another card.
  </Accordion>
</AccordionGroup>

### Export redemptions

You can export redemptions from the main **Redemptions** tab or from a selected campaign.

Use filters to narrow down the results.

<Tip>
  To export redemptions for a specific voucher or vouchers, use the **Voucher code** filter.
</Tip>

## Related features

Learn more about features related to voucher tracking.

<AccordionGroup>
  <Accordion title="Campaign tracking">
    For campaign performance and analytics, see [Campaign tracking](/analyze/campaign-tracking).
  </Accordion>

  <Accordion title="Categories and stacking rules">
    Categories can be used to organize vouchers and campaigns, but they are primarily used for stacking rules.

    Stacking rules define how incentives like vouchers behave when they're redeemed together. Stacking rules can influence the order of application, which incentives can be used exclusively, how discounts are calculated together, and many other details.

    Learn more about [stacking rules and categories](/orchestrate/stacking-rules-overview).
  </Accordion>

  <Accordion title="Developer setup">
    Track voucher activity programmatically with the Voucherify API. Use these endpoints to inspect redemptions, validations, gift card and loyalty card transactions.

    Redemptions:

    * [List redemptions](/api-reference/redemptions/list-redemptions): List all redemptions across the project, with filters for voucher, customer, campaign, result, and date range.
    * [Get voucher's redemptions](/api-reference/redemptions/get-vouchers-redemptions): List redemptions for a specific voucher code.
    * [Redemption object](/api-reference/redemptions/redemption-object): Schema reference for redemption payloads.
    * [Rollback redemption](/api-reference/redemptions/rollback-redemption) / [Rollback stackable redemptions](/api-reference/redemptions/rollback-stackable-redemptions): Reverse a redemption.

    Gift card and loyalty card transactions:

    * [List voucher transactions](/api-reference/vouchers/list-voucher-transactions): List credit or point transactions for a single voucher.
    * [Export voucher transactions](/api-reference/vouchers/export-voucher-transactions): Trigger a CSV export of transactions for a voucher.
    * [List campaign transactions](/api-reference/campaigns/list-campaign-transactions) / [Export campaign transactions](/api-reference/campaigns/export-campaign-transactions): Transactions across all vouchers in a campaign.

    Exports:

    * Use the [Exports API](/api-reference/exports/create-export) to generate CSV exports of vouchers, redemptions, and transactions.
  </Accordion>

  <Accordion title="Developer setup: Voucher events in webhooks">
    You can also subscribe to voucher events with webhooks (for example, `voucher.redeemed`, `voucher.updated`, `voucher.disabled`) to receive activity in real time. See:

    * [Introduction to webhooks](/api-reference/introduction-to-webhooks)
    * [Project settings webhooks](/api-reference/project-settings-webhooks)
    * [Distribution webhooks](/api-reference/distribution-webhooks)

    Learn more about the following voucher events:

    * [Voucher created](/api-reference/voucher/created)
    * [Voucher disabled](/api-reference/voucher/disabled)
    * [Voucher enabled](/api-reference/voucher/enabled)
    * [Voucher updated](/api-reference/voucher/updated)
    * [Voucher published](/api-reference/voucher/published)
    * [Voucher loyalty card pending points activated](/api-reference/voucher/loyalty-card-pending-points-activated)
    * [Voucher loyalty card pending points added](/api-reference/voucher/loyalty-card-pending-points-added)
    * [Voucher loyalty card pending points canceled](/api-reference/voucher/loyalty-card-pending-points-canceled)
    * [Voucher loyalty card pending points updated](/api-reference/voucher/loyalty-card-pending-points-updated)
    * [Voucher loyalty card points added](/api-reference/voucher/loyalty-card-points-added)
    * [Voucher loyalty card points expired](/api-reference/voucher/loyalty-card-points-expired)
    * [Voucher loyalty card transaction created](/api-reference/voucher/loyalty-card-transaction-created)
    * [Voucher gift transaction created](/api-reference/voucher/gift-transaction-created)
    * [Voucher gift balance added](/api-reference/voucher/gift-balance-added)
    * [Voucher deleted](/api-reference/voucher/deleted)
  </Accordion>
</AccordionGroup>