List program tiers daily reports

Returns aggregated tier-movement statistics for the program over the given date range and resolution, optionally filtered by tier structure and tier. Each row covers one tier structure, one tier, and one period with recorded movement. Periods without recorded movement 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/tiers/daily

List program tiers daily reports

cURL

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

200

Daily tiers report

{
  "data": [
    {
      "date": "2026-07-01",
      "tier_structure_id": "lts_128f4a88414c4bed69",
      "tier_id": "lt_128f4a88414c4bed6a",
      "joins": 1,
      "upgrades": 0,
      "downgrades": 0,
      "lefts": 0,
      "prolongs": 0,
      "object": "program_tiers_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.

Query Parameters

start_date · string<date> · required

Sets the inclusive start of the range, in YYYY-MM-DD format.

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

end_date · string<date> · required

Sets the inclusive end of the range, in YYYY-MM-DD format. Must be after start_date.

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

resolution · enum<string> · required

Sets the aggregation resolution. Allowed range: day up to 90 days, week up to 12 weeks, month up to 12 months, quarter up to 4 quarters.

Available options: day, week, month, quarter

filters · object

Filters rows by tier_structure_id and tier_id. Example: filters[tier_structure_id][conditions][$is]=lts_.... Filters for program tiers reports.

Show child attributes

Response

200

application/json

Program tiers daily report.

Response body schema for GET /v2/loyalties/programs/{programId}/reports/tiers/daily.

data · object[] · required

List of report entries, one per tier structure, tier, and aggregation period with recorded movement, ordered by date ascending. Empty when no movement was recorded in the range.

Show child attributes

object · string · required

Object type marker. Always report.

Allowed value: "report"