List program points-earnings daily reports

Returns aggregated daily points-earnings statistics for the program over the given date range and resolution, optionally filtered by earning rule and card definition. Each entry sums earning operations recorded for one period, earning rule, earning item, and card definition. Periods without recorded activity are omitted. A filter that matches no rows returns an empty data array.

The date range is limited per resolution:

• 90 days for day,
• 12 weeks for week,
• 12 months for month,
• 4 quarters for quarter,
• start_date must be before end_date,
• start_date and end_date are inclusive.

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

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

List program points-earnings daily reports

cURL

curl --request GET \
  --url https://{cluster}.voucherify.io/v2/loyalties/programs/{programId}/reports/points-earnings/daily \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>'

200

Program points-earnings daily report: Day resolution

{
  "data": [
    {
      "date": "2026-07-01",
      "earning_rule_id": "lern_128f9ee63cc4ba558",
      "earning_item_id": "lernei_128f582238cc4bf78e",
      "card_definition_id": "lcdef_128f58429f4c4bf7b2",
      "success_count": 1,
      "points": 100,
      "pending_points": 0,
      "object": "program_points_earnings_daily_report"
    }
  ],
  "object": "report"
}

Authorizations

X-App-Id & X-App-TokenbearerAuth

X-App-Id · string · header · required

X-App-Token · string · header · required

Path Parameters

programId · string · required

Identifies the loyalty program. Format: lprg_ followed by hexadecimal characters.

Pattern: ^lprg_[a-f0-9]+$

Query Parameters

start_date · string<date> · required

Start of the report date range (inclusive), in YYYY-MM-DD format.

Pattern: ^\d{4}-\d{2}-\d{2}$

end_date · string<date> · required

End of the report date range (inclusive), in YYYY-MM-DD format. Must be after start_date.

Pattern: ^\d{4}-\d{2}-\d{2}$

resolution · enum<string> · required

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.

Available options: day, week, month, quarter

filters · object | null

Filters rows by earning rule ID and card definition ID. Each field takes a conditions object. Omitting filters or setting it to null applies no field filters. Filters for program points-earnings reports.

Show child attributes

Response

200

application/json

Program points-earnings daily report.

Response body schema for GET /v2/loyalties/programs/{programId}/reports/points-earnings/daily.

data · object[] · required

List of report entries, one per aggregation period, earning rule, earning item, and card definition with recorded activity, ordered by date ascending. Empty when no activity was recorded in the range.

Show child attributes

object · string · required

Object type marker. Always report.

Allowed value: "report"