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

# Get program tiers daily report

`GET /v2/loyalties/programs/{programId}/reports/tiers/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 tier-movement statistics for the program over the given
date range and resolution, optionally filtered by tier structure and tier.

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

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `resolution` 'day' | 'week' | 'month' | 'quarter', required
- `filters` TiersReportListFilters — Filters for program tiers reports.
  - `junction` 'AND' | 'OR', nullable — Logical junction between the field filters. Defaults to AND behavior.
  - `tier_structure_id` TiersReportFilterTierStructureIdConditions — ID filter conditions for tier structure id. Values must match pattern `^lts_[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 tier structure id equals the given value.
        - string
        - string[]
      - `$is_not` union — Matches rows whose tier structure id does not equal the given value.
        - string
        - string[]
      - `$in` union — Matches rows whose tier structure id is one of the given values.
        - string
        - string[]
      - `$not_in` union — Matches rows whose tier structure id is not one of the given values.
        - string
        - string[]
  - `tier_id` TiersReportFilterTierIdConditions — ID filter conditions for tier id. Values must match pattern `^lt_[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 tier id equals the given value.
        - string
        - string[]
      - `$is_not` union — Matches rows whose tier id does not equal the given value.
        - string
        - string[]
      - `$in` union — Matches rows whose tier id is one of the given values.
        - string
        - string[]
      - `$not_in` union — Matches rows whose tier id is not one of the given values.
        - string
        - string[]

## Response `200`

Program tiers daily report.

- TiersReportDailyResponse — Program tiers daily report result.
  - `data` TiersReportDailyEntry[] — Report entries, one per aggregation period, tier structure, and tier.
    - `date` string, date — Date of the aggregation period (`YYYY-MM-DD`).
    - `tier_structure_id` string — Unique identifier of the tier structure (format `lts_...`).
    - `tier_id` string — Unique identifier of the tier (format `lt_...`).
    - `joins` number — Number of members who joined this tier in the period.
    - `upgrades` number — Number of upgrades into this tier in the period.
    - `downgrades` number — Number of downgrades into this tier in the period.
    - `lefts` number — Number of members who left this tier in the period.
    - `prolongs` number — Number of tier prolongations in the period.
    - `object` 'program_tiers_daily_report' — Object type marker. Always `program_tiers_daily_report`.
  - `object` 'report' — Object type marker. Always `report`.

## Other responses

- `400` — Validation error - query parameters failed validation, or the operation is not allowed in the current resource state.
- `404` — Resource not found.
- `500` — Internal 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)