> ## Documentation Index
> Fetch the complete documentation index at: https://voucherify-rc-lv2-guides.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Get program points-earnings daily report
>
Documentation in progress
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.
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`.
## OpenAPI
````yaml /openapi/loyalties-v2.json get /v2/loyalties/programs/{programId}/reports/points-earnings/daily
openapi: 3.1.0
info:
title: Voucherify Loyalty v2 API
version: 2.0.0
description: >-
Complete OpenAPI specification for the Voucherify Loyalty v2 API.
All endpoints require the LOYALTY_V2 feature flag.
Combined from per-domain specs: programs.yaml, members.yaml,
program-operations.yaml, card-definitions.yaml, earning-rules.yaml,
tier-structures.yaml, benefits.yaml, rewards.yaml, examine.yaml
servers:
- url: '{protocol}://{host}'
variables:
protocol:
default: https
enum:
- https
- http
host:
default: api.voucherify.io
security:
- X-App-Id: []
X-App-Token: []
- bearerAuth: []
tags:
- name: Programs
description: >-
Loyalty program CRUD, lifecycle management, program-scoped resource
assignments (card definitions, earning rules, rewards, tier structures),
member management (create, list, get, update, activate, deactivate,
delete), membership retrieval (member + program + cards with tier
progress, by customer ID, customer source ID, or member ID), card
operations (points adjustment, pending points, expiring points,
transactions), reward purchases, and activity history.
- name: Card definitions
description: >-
CRUD operations, lifecycle management, and activity history for card
definitions. Card definitions describe the configuration for loyalty
cards, including code generation, points expiration, earning/spending
limits, pending points, refunds, and balance settings.
- name: Earning rules
description: >-
Manage earning rules that define how customers earn points or receive
incentives based on triggers (events, segments, custom events). Includes
CRUD, lifecycle, and activity history.
- name: Tier structures
description: >-
CRUD operations, lifecycle management, and activity history for tier
structures. Includes nested tier definitions (create, list, update,
delete) within tier structures. Tier structures define the tiering model
for loyalty programs — how members qualify for and move between tiers.
- name: Benefits
description: >-
Manage benefit definitions (fixed points, proportional points, material,
digital). Includes CRUD, lifecycle transitions, and activity history.
- name: Rewards
description: >-
CRUD, lifecycle operations, and activity history for reward definitions.
Rewards can be material (product/SKU) or digital (discount coupons, gift
vouchers).
- name: Examine
description: >-
Evaluation endpoints that estimate earning opportunities and reward
availability for a customer across their loyalty program memberships,
without side effects.
paths:
/v2/loyalties/programs/{programId}/reports/points-earnings/daily:
get:
tags:
- Programs
summary: Get program points-earnings daily report
description: >-
Documentation in progress
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.
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`.
operationId: getProgramPointsEarningsDailyReport
parameters:
- name: programId
in: path
required: true
description: >-
Unique loyalty program identifier (format: `lprg_` followed by
hexadecimal characters).
schema:
type: string
pattern: ^lprg_[a-f0-9]+$
- name: start_date
in: query
required: true
description: Start of the report date range (inclusive), in `YYYY-MM-DD` format.
schema:
type: string
format: date
pattern: ^\d{4}-\d{2}-\d{2}$
- name: end_date
in: query
required: true
description: >-
End of the report date range, in `YYYY-MM-DD` format. Must be after
`start_date`.
schema:
type: string
format: date
pattern: ^\d{4}-\d{2}-\d{2}$
- name: resolution
in: query
required: true
description: >-
Aggregation resolution of the report. The allowed date range depends
on the resolution: `day` — max 90 days, `week` — max 12 weeks,
`month` — max 12 months, `quarter` — max 4 quarters.
schema:
type: string
enum:
- day
- week
- month
- quarter
- name: filters
in: query
required: false
style: deepObject
explode: true
description: >-
Field filters. Each field accepts a `conditions` object with
condition operators.
schema:
$ref: '#/components/schemas/PointsEarningsReportListFilters'
responses:
'200':
description: Program points-earnings daily report.
content:
application/json:
schema:
$ref: '#/components/schemas/PointsEarningsReportDailyResponse'
'400':
description: >-
Validation error - request body or query parameters failed
validation, or the operation is not allowed in the current resource
state.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Resource not found.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Unexpected server error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
PointsEarningsReportListFilters:
type: object
description: Filters for program points-earnings reports.
properties:
junction:
description: >-
Logical junction between the field filters. Defaults to AND
behavior.
oneOf:
- type: string
enum:
- AND
- OR
- type: 'null'
earning_rule_id:
description: Filter by earning rule id.
oneOf:
- $ref: >-
#/components/schemas/PointsEarningsReportFilterEarningRuleIdConditions
- type: 'null'
card_definition_id:
description: Filter by card definition id.
oneOf:
- $ref: >-
#/components/schemas/PointsEarningsReportFilterCardDefinitionIdConditions
- type: 'null'
additionalProperties: false
PointsEarningsReportDailyResponse:
type: object
description: Program points-earnings daily report result.
properties:
data:
type: array
description: >-
Report entries, one per aggregation period, earning rule, earning
item, and card definition.
items:
$ref: '#/components/schemas/PointsEarningsReportDailyEntry'
object:
type: string
const: report
description: Object type marker. Always `report`.
ErrorResponse:
type: object
description: Standard error response returned by all Loyalty v2 endpoints.
properties:
code:
type: integer
description: HTTP status code of the error.
key:
type: string
description: Machine-readable error key.
message:
type: string
description: Human-readable error message.
details:
type: string
description: Additional details about the error.
request_id:
type: string
description: Unique identifier of the request that produced the error.
resource_id:
type: string
description: Unique identifier of the resource that produced the error.
resource_type:
type: string
description: Type of the resource that produced the error.
PointsEarningsReportFilterEarningRuleIdConditions:
type: object
description: >-
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.
properties:
conditions:
type: object
minProperties: 1
additionalProperties: false
properties:
$is:
description: Matches rows whose earning rule id equals the given value.
oneOf:
- type: string
pattern: ^lern_[a-f0-9]+$
- type: array
minItems: 1
maxItems: 1
items:
type: string
pattern: ^lern_[a-f0-9]+$
- type: 'null'
$is_not:
description: >-
Matches rows whose earning rule id does not equal the given
value.
oneOf:
- type: string
pattern: ^lern_[a-f0-9]+$
- type: array
minItems: 1
maxItems: 1
items:
type: string
pattern: ^lern_[a-f0-9]+$
- type: 'null'
$in:
description: Matches rows whose earning rule id is one of the given values.
oneOf:
- type: string
pattern: ^lern_[a-f0-9]+$
- type: array
minItems: 1
maxItems: 100
items:
type: string
pattern: ^lern_[a-f0-9]+$
- type: 'null'
$not_in:
description: >-
Matches rows whose earning rule id is not one of the given
values.
oneOf:
- type: string
pattern: ^lern_[a-f0-9]+$
- type: array
minItems: 1
maxItems: 100
items:
type: string
pattern: ^lern_[a-f0-9]+$
- type: 'null'
required:
- conditions
additionalProperties: false
PointsEarningsReportFilterCardDefinitionIdConditions:
type: object
description: >-
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.
properties:
conditions:
type: object
minProperties: 1
additionalProperties: false
properties:
$is:
description: Matches rows whose card definition id equals the given value.
oneOf:
- type: string
pattern: ^lcdef_[a-f0-9]+$
- type: array
items:
type: string
pattern: ^lcdef_[a-f0-9]+$
minItems: 1
maxItems: 1
- type: 'null'
$is_not:
description: >-
Matches rows whose card definition id does not equal the given
value.
oneOf:
- type: string
pattern: ^lcdef_[a-f0-9]+$
- type: array
items:
type: string
pattern: ^lcdef_[a-f0-9]+$
minItems: 1
maxItems: 1
- type: 'null'
$in:
description: >-
Matches rows whose card definition id is one of the given
values.
oneOf:
- type: string
pattern: ^lcdef_[a-f0-9]+$
- type: array
items:
type: string
pattern: ^lcdef_[a-f0-9]+$
minItems: 1
maxItems: 100
- type: 'null'
$not_in:
description: >-
Matches rows whose card definition id is not one of the given
values.
oneOf:
- type: string
pattern: ^lcdef_[a-f0-9]+$
- type: array
items:
type: string
pattern: ^lcdef_[a-f0-9]+$
minItems: 1
maxItems: 100
- type: 'null'
required:
- conditions
additionalProperties: false
PointsEarningsReportDailyEntry:
type: object
description: >-
Aggregated daily program points-earnings statistics for one period,
earning rule, earning item, and card definition. All numeric fields
default to 0.
properties:
date:
type: string
format: date
description: Date of the aggregation period (`YYYY-MM-DD`).
earning_rule_id:
type: string
pattern: ^lern_[a-f0-9]+$
description: Unique identifier of the earning rule (format `lern_...`).
earning_item_id:
type: string
description: Identifier of the earning item that produced the points.
card_definition_id:
type: string
pattern: ^lcdef_[a-f0-9]+$
description: Unique identifier of the card definition (format `lcdef_...`).
success_count:
type: number
description: Number of successful earning operations in the period.
points:
type: number
description: Total points earned in the period.
pending_points:
type: number
description: Total pending points earned in the period.
object:
type: string
const: program_points_earnings_daily_report
description: Object type marker. Always `program_points_earnings_daily_report`.
securitySchemes:
X-App-Id:
type: apiKey
name: X-App-Id
in: header
X-App-Token:
type: apiKey
name: X-App-Token
in: header
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
````