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

# List program members summary reports

`GET /v2/loyalties/programs/{programId}/reports/members/summary`

## Request

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

Returns all-time member and card totals for the program. The response contains one row when activity was recorded, and an empty `data` array otherwise. `limit` and `order` are not query parameters.

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

## Response `200`

Program members summary report.

- LoyaltiesProgramsReportsMembersSummaryListResponseBody: Response body schema for **GET** `/v2/loyalties/programs/{programId}/reports/members/summary`.
  - `data` MembersReportSummaryEntry[], required: List of summary rows for the program. Contains one row when activity was recorded, ordered by `id` descending. Empty when no activity was recorded.
    - `id` string, required: Identifies the summary row (format: `lpmrs_` followed by hexadecimal characters).
    - `members_joined` number, required: Counts members who joined the program.
    - `members_deactivated` number, required: Counts members deactivated. Decreases by 1 when a member is activated again.
    - `members_deleted` number, required: Counts members deleted.
    - `cards` number, required: Counts cards created. Decreases by 1 when a card is unassigned (e.g. when a member is deleted).
    - `object` 'program_members_summary_report', required: Object type marker. Always `program_members_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) `be14b3318eb3`: 1 info
  - api operation id `getProgramMembersSummaryReport` removed and replaced with `listProgramMembersSummaryReports`
- **2026-10-14** (v2) `6a418ac8b7b1`: 1 info
  - api operation id `listProgramMembersSummaryReports` removed and replaced with `getProgramMembersSummaryReport`
- **2026-10-14** (v2) `b3bda0b5853f`: 1 info
  - endpoint added
- **2026-10-14** (v2) `f0e2ed1d9df6`: 1 breaking
  - api path removed without deprecation
- **2026-10-13** (v2) `1718b25064f4`: 1 info
  - api operation id `getProgramMembersSummaryReport` removed and replaced with `listProgramMembersSummaryReports`

[Operation history](https://skmtc.dev/voucherifyio/apis/voucherify-loyalty-v2-api/changes/v2/loyalties/programs/:programId/reports/members/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)