> ## Documentation Index > Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi/loyalties-v2.json get /v2/loyalties/programs/{programId}/reports/tiers/daily openapi: 3.1.0 info: title: Voucherify API - Loyalty v2 version: v2018-08-01 description: >- Voucherify promotion engine REST API. Please see https://docs.voucherify.io/docs for more details. contact: name: Voucherify Team url: https://www.voucherify.io/contact-support email: support@voucherify.io termsOfService: https://www.voucherify.io/legal/subscription-agreement license: name: MIT url: https://github.com/voucherifyio/voucherify-js-sdk/blob/main/LICENSE servers: - url: https://{cluster}.voucherify.io description: Base URL variables: cluster: default: api enum: - api - us1.api - as1.api - download - us1.download - as1.download security: [] paths: /v2/loyalties/programs/{programId}/reports/tiers/daily: parameters: - name: programId in: path required: true description: >- Identifies the loyalty program. Format: `lprg_` followed by hexadecimal characters. schema: type: string get: tags: - Programs summary: List program tiers daily reports description: >- 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. operationId: listProgramTiersDailyReports parameters: - name: start_date in: query required: true description: Sets the inclusive start of the range, 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: >- Sets the inclusive end of the 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: >- 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. schema: type: string enum: - day - week - month - quarter - name: filters in: query required: false style: deepObject explode: true description: >- Filters rows by `tier_structure_id` and `tier_id`. Example: `filters[tier_structure_id][conditions][$is]=lts_...`. schema: $ref: '#/components/schemas/TiersReportListFilters' responses: '200': description: Program tiers daily report. content: application/json: schema: $ref: >- #/components/schemas/V2LoyaltiesProgramsReportsTiersDailyListResponseBody examples: Daily tiers report: value: 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 Monthly tiers report: value: data: - date: '2026-07-01' tier_structure_id: lts_128f4b460e4c4bedf6 tier_id: lt_128f4b46400c4bedfb joins: 0 upgrades: 0 downgrades: 2 lefts: 0 prolongs: 0 object: program_tiers_daily_report - date: '2026-07-01' tier_structure_id: lts_128f4b460e4c4bedf6 tier_id: lt_128f4b46558c4bedff joins: 0 upgrades: 0 downgrades: 1 lefts: 0 prolongs: 0 object: program_tiers_daily_report - date: '2026-07-01' tier_structure_id: lts_128f4b460e4c4bedf6 tier_id: lt_128f4b46808c4bee07 joins: 0 upgrades: 2 downgrades: 0 lefts: 0 prolongs: 0 object: program_tiers_daily_report - date: '2026-08-01' tier_structure_id: lts_128f4b460e4c4bedf6 tier_id: lt_128f4b46808c4bee07 joins: 0 upgrades: 1 downgrades: 0 lefts: 0 prolongs: 0 object: program_tiers_daily_report - date: '2026-08-01' tier_structure_id: lts_128f4b460e4c4bedf6 tier_id: lt_128f4b466a0c4bee03 joins: 0 upgrades: 1 downgrades: 0 lefts: 0 prolongs: 0 object: program_tiers_daily_report - date: '2026-08-01' tier_structure_id: lts_128f4b460e4c4bedf6 tier_id: lt_128f4b46400c4bedfb joins: 0 upgrades: 0 downgrades: 1 lefts: 0 prolongs: 0 object: program_tiers_daily_report - date: '2026-09-01' tier_structure_id: lts_128f4b460e4c4bedf6 tier_id: lt_128f4b46808c4bee07 joins: 0 upgrades: 1 downgrades: 0 lefts: 0 prolongs: 0 object: program_tiers_daily_report - date: '2026-09-01' tier_structure_id: lts_128f4b460e4c4bedf6 tier_id: lt_128f4b46400c4bedfb joins: 2 upgrades: 0 downgrades: 0 lefts: 1 prolongs: 0 object: program_tiers_daily_report - date: '2026-10-01' tier_structure_id: lts_128f4b460e4c4bedf6 tier_id: lt_128f4b46400c4bedfb joins: 1 upgrades: 0 downgrades: 1 lefts: 0 prolongs: 0 object: program_tiers_daily_report object: report Empty tiers daily report: value: data: [] object: report '400': description: >- Query parameters failed validation, or `start_date` is not before `end_date`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: 'Invalid query parameters: `start_date` is required': value: code: 400 key: invalid_query_params message: Invalid query params details: Query must have required property 'start_date' request_id: v-131e4b76ad2e098901 'Invalid query parameters: `end_date` is required': value: code: 400 key: invalid_query_params message: Invalid query params details: Query must have required property 'end_date' request_id: v-131e4b76ad2e098902 'Invalid query parameters: `resolution` is required': value: code: 400 key: invalid_query_params message: Invalid query params details: Query must have required property 'resolution' request_id: v-131e4b76ad2e098903 'Invalid query parameters: `resolution` is invalid': value: code: 400 key: invalid_query_params message: Invalid query params details: >- Property .resolution must be equal to one of the allowed values [ day, week, month, quarter ] request_id: v-131e4b76ad2e098904 'Invalid query parameters: `start_date` is invalid': value: code: 400 key: invalid_query_params message: Invalid query params details: >- Property .start_date cannot be recognized as a ISO-8601 compliant date request_id: v-131e4b76ad2e098905 'Invalid query parameters: `end_date` is invalid': value: code: 400 key: invalid_query_params message: Invalid query params details: >- Property .end_date cannot be recognized as a ISO-8601 compliant date request_id: v-131e4b76ad2e098909 'Invalid query parameters: date range exceeds limit for `day`': value: code: 400 key: invalid_query_params message: Invalid query params details: >- Query date range exceeds maximum allowed 90 days for resolution 'day' request_id: v-131e4b76ad2e098906 'Invalid query parameters: date range exceeds limit for `week`': value: code: 400 key: invalid_query_params message: Invalid query params details: >- Query date range exceeds maximum allowed 12 weeks for resolution 'week' request_id: v-131e4b76ad2e09890a 'Invalid query parameters: date range exceeds limit for `month`': value: code: 400 key: invalid_query_params message: Invalid query params details: >- Query date range exceeds maximum allowed 12 months for resolution 'month' request_id: v-131e4b76ad2e09890b 'Invalid query parameters: date range exceeds limit for `quarter`': value: code: 400 key: invalid_query_params message: Invalid query params details: >- Query date range exceeds maximum allowed 4 quarters for resolution 'quarter' request_id: v-131e4b76ad2e09890c 'Invalid payload: `start_date` is not before `end_date`': value: code: 400 key: invalid_payload message: Invalid payload details: Property 'start_date' must be before 'end_date' request_id: v-131e4b76ad2e098907 '404': description: Program not found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: Program not found: value: code: 404 key: not_found message: Resource not found details: Cannot find program with id lprg_128f4a88414c4bed69 request_id: v-131e4b76ad2e098908 resource_id: lprg_128f4a88414c4bed69 resource_type: program Program id does not match the pattern: value: code: 404 key: not_found message: Resource not found details: Cannot find program with id missing request_id: v-131e4b76ad2e09890d resource_id: missing resource_type: program '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: Internal server error: value: code: 500 key: api_error message: >- Something went wrong. Don't worry, your campaigns are still safe and the Voucherify Team has been notified. Check out our Help Center and forums for help, or head back to home. security: - X-App-Id: [] X-App-Token: [] - bearerAuth: [] components: schemas: TiersReportListFilters: type: object description: Filters for program tiers reports. properties: junction: description: >- Joins the field filters. Allowed values: `AND`, `OR`. Defaults to `AND`. oneOf: - type: string enum: - AND - OR - type: 'null' tier_structure_id: description: Filter by tier structure ID. oneOf: - $ref: '#/components/schemas/TiersReportFilterTierStructureIdConditions' - type: 'null' tier_id: description: Filter by tier ID. oneOf: - $ref: '#/components/schemas/TiersReportFilterTierIdConditions' - type: 'null' additionalProperties: false V2LoyaltiesProgramsReportsTiersDailyListResponseBody: title: V2 Loyalties Programs Reports Tiers Daily List Response Body type: object description: >- Response body schema for **GET** `/v2/loyalties/programs/{programId}/reports/tiers/daily`. allOf: - $ref: '#/components/schemas/TiersReportDailyResponse' 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. TiersReportFilterTierStructureIdConditions: type: object description: >- 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. properties: conditions: type: object minProperties: 1 additionalProperties: false properties: $is: description: Matches rows whose tier structure id equals the given value. oneOf: - type: string pattern: ^lts_[a-f0-9]+$ - type: array items: type: string pattern: ^lts_[a-f0-9]+$ minItems: 1 maxItems: 1 - type: 'null' $is_not: description: >- Matches rows whose tier structure id does not equal the given value. oneOf: - type: string pattern: ^lts_[a-f0-9]+$ - type: array items: type: string pattern: ^lts_[a-f0-9]+$ minItems: 1 maxItems: 1 - type: 'null' $in: description: Matches rows whose tier structure id is one of the given values. oneOf: - type: string pattern: ^lts_[a-f0-9]+$ - type: array items: type: string pattern: ^lts_[a-f0-9]+$ minItems: 1 maxItems: 100 - type: 'null' $not_in: description: >- Matches rows whose tier structure id is not one of the given values. oneOf: - type: string pattern: ^lts_[a-f0-9]+$ - type: array items: type: string pattern: ^lts_[a-f0-9]+$ minItems: 1 maxItems: 100 - type: 'null' required: - conditions additionalProperties: false TiersReportFilterTierIdConditions: type: object description: >- 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. properties: conditions: type: object minProperties: 1 additionalProperties: false properties: $is: description: Matches rows whose tier ID equals the given value. oneOf: - type: string pattern: ^lt_[a-f0-9]+$ - type: array items: type: string pattern: ^lt_[a-f0-9]+$ minItems: 1 maxItems: 1 - type: 'null' $is_not: description: Matches rows whose tier ID does not equal the given value. oneOf: - type: string pattern: ^lt_[a-f0-9]+$ - type: array items: type: string pattern: ^lt_[a-f0-9]+$ minItems: 1 maxItems: 1 - type: 'null' $in: description: Matches rows whose tier ID is one of the given values. oneOf: - type: string pattern: ^lt_[a-f0-9]+$ - type: array items: type: string pattern: ^lt_[a-f0-9]+$ minItems: 1 maxItems: 100 - type: 'null' $not_in: description: Matches rows whose tier ID is not one of the given values. oneOf: - type: string pattern: ^lt_[a-f0-9]+$ - type: array items: type: string pattern: ^lt_[a-f0-9]+$ minItems: 1 maxItems: 100 - type: 'null' required: - conditions additionalProperties: false TiersReportDailyResponse: type: object description: Program tiers daily report result. properties: data: type: array description: >- 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. items: $ref: '#/components/schemas/TiersReportDailyEntry' object: type: string const: report description: Object type marker. Always `report`. required: - data - object TiersReportDailyEntry: type: object description: >- Aggregated daily program tier-movement statistics for one period, tier structure, and tier. All numeric fields default to 0. properties: date: type: string format: date description: >- Identifies the start of the aggregation period on the project-local calendar (`YYYY-MM-DD`). The date is truncated to the resolution. For `week` this is Monday. For `month` this is the first day. For `quarter` this is the quarter start. tier_structure_id: type: string pattern: ^lts_[a-f0-9]+$ description: Unique identifier of the tier structure (format `lts_...`). tier_id: type: string pattern: ^lt_[a-f0-9]+$ description: Unique identifier of the tier (format `lt_...`). joins: type: number description: Number of members who joined this tier in the period. upgrades: type: number description: Number of upgrades into this tier in the period. downgrades: type: number description: Number of downgrades into this tier in the period. lefts: type: number description: Number of members who left this tier in the period. prolongs: type: number description: >- Counts expiration-date changes for members who stayed on this tier in the period. object: type: string const: program_tiers_daily_report description: Object type marker. Always `program_tiers_daily_report`. required: - date - tier_structure_id - tier_id - joins - upgrades - downgrades - lefts - prolongs - object 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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.