---
title: "Get program points-earnings daily report"
method: GET
path: "/v2/loyalties/programs/{programId}/reports/points-earnings/daily"
tags: ["Programs"]
---

# Get program points-earnings daily report

`GET /v2/loyalties/programs/{programId}/reports/points-earnings/daily`

<Info>

<Badge color="gray">Documentation in progress</Badge>

This documentation is in progress. The parameters, fields, request and response bodies, and other data may be subject to change. If you need more information or you want to share feedback, contact [Voucherify support](https://www.voucherify.io/contact-support) or your Technical Account Manager.

</Info>

Returns aggregated daily points-earnings statistics for the program over the given date range and resolution, optionally filtered by earning rule and card definition.

The date range is limited per resolution:
maximum 90 days for `day`, 12 weeks for `week`, 12 months for `month`, 4 quarters for `quarter`.

## Path parameters

- `programId` string, required

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `resolution` 'day' | 'week' | 'month' | 'quarter', required
- `filters` PointsEarningsReportListFilters — Filters for program points-earnings reports.
  - `junction` 'AND' | 'OR', nullable — Logical junction between the field filters. Defaults to AND behavior.
  - `earning_rule_id` PointsEarningsReportFilterEarningRuleIdConditions — ID filter conditions for earning rule id. Values must match pattern `^lern_[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 rows whose earning rule id equals the given value.
        - string
        - string[]
      - `$is_not` union — Matches rows whose earning rule id does not equal the given value.
        - string
        - string[]
      - `$in` union — Matches rows whose earning rule id is one of the given values.
        - string
        - string[]
      - `$not_in` union — Matches rows whose earning rule id is not one of the given values.
        - string
        - string[]
  - `card_definition_id` PointsEarningsReportFilterCardDefinitionIdConditions — ID filter conditions for card definition id. 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 rows whose card definition id equals the given value.
        - string
        - string[]
      - `$is_not` union — Matches rows whose card definition id does not equal the given value.
        - string
        - string[]
      - `$in` union — Matches rows whose card definition id is one of the given values.
        - string
        - string[]
      - `$not_in` union — Matches rows whose card definition id is not one of the given values.
        - string
        - string[]

## Response `200`

Program points-earnings daily report.

- PointsEarningsReportDailyResponse — Program points-earnings daily report result.
  - `data` PointsEarningsReportDailyEntry[] — Report entries, one per aggregation period, earning rule, earning item, and card definition.
    - `date` string, date — Date of the aggregation period (`YYYY-MM-DD`).
    - `earning_rule_id` string — Unique identifier of the earning rule (format `lern_...`).
    - `earning_item_id` string — Identifier of the earning item that produced the points.
    - `card_definition_id` string — Unique identifier of the card definition (format `lcdef_...`).
    - `success_count` number — Number of successful earning operations in the period.
    - `points` number — Total points earned in the period.
    - `pending_points` number — Total pending points earned in the period.
    - `object` 'program_points_earnings_daily_report' — Object type marker. Always `program_points_earnings_daily_report`.
  - `object` 'report' — Object type marker. Always `report`.

## Other responses

- `400` — Validation error - request body or query parameters failed validation, or the operation is not allowed in the current resource state.
- `404` — Resource not found.
- `500` — Unexpected server error.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-loyalty-v2-api.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-loyalty-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-loyalty-v2-api/revisions/69be73b5cff0/schema)