---
title: "List program rewards spendings summary reports"
method: GET
path: "/v2/loyalties/programs/{programId}/reports/rewards/spendings/summary"
tags: ["Programs"]
---

# List program rewards spendings summary reports

`GET /v2/loyalties/programs/{programId}/reports/rewards/spendings/summary`

## Request

- Base URL: `https://api.voucherify.io`
- URL: `https://api.voucherify.io/v2/loyalties/programs/{programId}/reports/rewards/spendings/summary`
- Auth: one of:
  - API key in header `X-App-Id` and API key in header `X-App-Token`
  - HTTP bearer

Returns all-time points spent on reward purchases for the program. Each row covers one reward, reward cost, reward spending, and card definition with an approved point spend. Filters rows by reward, cost, spending, and card definition. Returns at most 100 rows, ordered by `id` descending. `limit` and `order` are not query parameters. A filter that matches no rows returns an empty `data` array.

Returns `400` when query validation fails. Returns `404` when the program does not exist.

## Query parameters

- `filters` RewardsSpendingsReportListFilters: Filters for program rewards spendings reports.
  - `junction` 'AND' | 'OR', nullable: Joins the field filters. Allowed values are `AND` and `OR`. Defaults to `AND`.
  - `reward_id` RewardsReportFilterRewardIdConditions: ID filter conditions for reward ID. Values must match pattern `^lrew_[a-f0-9]+$`. `$is` and `$is_not` accept a single value (string or 1-element array). `$in` and `$not_in` accept a string or an array of 1-100 values.
    - `conditions` object, required
      - `$is` union: Matches one value. A string or a one-element array. Format `lrew_[a-f0-9]+`.
        - string
        - string[]
      - `$is_not` union: Excludes one value. A string or a one-element array. Format `lrew_[a-f0-9]+`.
        - string
        - string[]
      - `$in` union: Matches any of the values. A string or an array of 1 to 100 values. Format `lrew_[a-f0-9]+`.
        - string
        - string[]
      - `$not_in` union: Excludes any of the values. A string or an array of 1 to 100 values. Format `lrew_[a-f0-9]+`.
        - string
        - string[]
  - `card_definition_id` ReportCardDefinitionIdFilterConditions: ID filter conditions for card definition IDs. Values must match pattern `^lcdef_[a-f0-9]+$`. `$is`/`$is_not` accept a single value (string or 1-element array); `$in`/`$not_in` accept a string or an array of 1-100 values.
    - `conditions` object, required
      - `$is` union: Matches one value. A string or a one-element array. Format `lcdef_[a-f0-9]+`.
        - string
        - string[]
      - `$is_not` union: Excludes one value. A string or a one-element array. Format `lcdef_[a-f0-9]+`.
        - string
        - string[]
      - `$in` union: Matches any of the values. A string or an array of 1 to 100 values. Format `lcdef_[a-f0-9]+`.
        - string
        - string[]
      - `$not_in` union: Excludes any of the values. A string or an array of 1 to 100 values. Format `lcdef_[a-f0-9]+`.
        - string
        - string[]
  - `cost_id` RewardsSpendingsReportFilterCostIdConditions: ID filter conditions for reward cost ID. Values must match pattern `^lrcst_[a-f0-9]+$`. `$is` and `$is_not` accept a single value (string or 1-element array). `$in` and `$not_in` accept a string or an array of 1-100 values.
    - `conditions` object, required
      - `$is` union: Matches one value. A string or a one-element array. Format `lrcst_[a-f0-9]+`.
        - string
        - string[]
      - `$is_not` union: Excludes one value. A string or a one-element array. Format `lrcst_[a-f0-9]+`.
        - string
        - string[]
      - `$in` union: Matches any of the values. A string or an array of 1 to 100 values. Format `lrcst_[a-f0-9]+`.
        - string
        - string[]
      - `$not_in` union: Excludes any of the values. A string or an array of 1 to 100 values. Format `lrcst_[a-f0-9]+`.
        - string
        - string[]
  - `spending_id` RewardsSpendingsReportFilterSpendingIdConditions: ID filter conditions for reward spending ID. Values must match pattern `^lrspn_[a-f0-9]+$`. `$is` and `$is_not` accept a single value (string or 1-element array). `$in` and `$not_in` accept a string or an array of 1-100 values.
    - `conditions` object, required
      - `$is` union: Matches one value. A string or a one-element array. Format `lrspn_[a-f0-9]+`.
        - string
        - string[]
      - `$is_not` union: Excludes one value. A string or a one-element array. Format `lrspn_[a-f0-9]+`.
        - string
        - string[]
      - `$in` union: Matches any of the values. A string or an array of 1 to 100 values. Format `lrspn_[a-f0-9]+`.
        - string
        - string[]
      - `$not_in` union: Excludes any of the values. A string or an array of 1 to 100 values. Format `lrspn_[a-f0-9]+`.
        - string
        - string[]

## Response `200`

Program rewards spendings summary report.

- LoyaltiesProgramsReportsRewardsSpendingsSummaryListResponseBody: Response body schema for **GET** `/v2/loyalties/programs/{programId}/reports/rewards/spendings/summary`.
  - `data` RewardsSpendingsReportSummaryEntry[], required: List of summary rows, one per reward, cost, spending, and card definition with an approved point spend, ordered by `id` descending. Contains at most 100 rows. Empty when no approved point spend was recorded.
    - `reward_id` string, required: Identifies the reward (`lrew_...`).
    - `cost_id` string, required: Identifies the reward cost (`lrcst_...`).
    - `spending_id` string, required: Identifies the reward spending (`lrspn_...`).
    - `card_definition_id` string, required: Identifies the card definition (`lcdef_...`).
    - `id` string, required: Identifies the summary row (format: `lprss_` followed by hexadecimal characters).
    - `success_count` number, required: Counts approved reward point spends.
    - `points` number, required: Totals points spent on those reward spends.
    - `object` 'program_rewards_spendings_summary_report', required: Object type marker. Always `program_rewards_spendings_summary_report`.
  - `object` 'report', required: Object type marker. Always `report`.

## Other responses

- `400`: Query parameters failed validation.
- `404`: Program not found.
- `500`: Internal server error.

## Changes

- **2026-10-14** (v2) `d29b33490051`: 9 breaking, 2 info
  - the `data/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/card_definition_id` from the response with the `200` status
  - removed the required property `data/items/cost_id` from the response with the `200` status
  - removed the required property `data/items/id` from the response with the `200` status
  - …7 more
- **2026-10-14** (v2) `be14b3318eb3`: 2 breaking, 10 info
  - for the `query` request parameter `filters`, the type changed from no type to `object`
  - the `data/items/` response's property type changed from no type to `object` for status `200`
  - api operation id `getProgramRewardsSpendingsSummaryReport` removed and replaced with `listProgramRewardsSpendingsSummaryReports`
  - removed `#/components/schemas/RewardsSpendingsReportEntryBase, subschema #2` from the `data/items/` response property `allOf` list for the response status `200`
  - …8 more
- **2026-10-14** (v2) `6a418ac8b7b1`: 9 breaking, 3 info
  - the `data/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/items/card_definition_id` from the response with the `200` status
  - removed the required property `data/items/cost_id` from the response with the `200` status
  - removed the required property `data/items/id` from the response with the `200` status
  - …8 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/changes/v2/loyalties/programs/:programId/reports/rewards/spendings/summary/get.md)

---

[API](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api.md) - [All operations](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/revisions/e0d9f2d2532f?raw)