> ## 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 rewards daily reports

> Returns aggregated reward-purchase statistics for the program over the given date range and resolution, optionally filtered by reward. Each row covers one reward and one period with recorded purchases. Periods without recorded purchases are omitted. `failures_breakdown` is always an empty object. 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/rewards/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/rewards/daily:
    parameters:
      - name: programId
        in: path
        required: true
        description: >-
          Identifies the loyalty program (`lprg_` followed by hexadecimal
          characters).
        schema:
          type: string
    get:
      tags:
        - Programs
      summary: List program rewards daily reports
      description: >-
        Returns aggregated reward-purchase statistics for the program over the
        given date range and resolution, optionally filtered by reward. Each row
        covers one reward and one period with recorded purchases. Periods
        without recorded purchases are omitted. `failures_breakdown` is always
        an empty object. 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: listProgramRewardsDailyReports
      parameters:
        - name: start_date
          in: query
          required: true
          description: >-
            Sets the inclusive start of the report date 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 report date range, in `YYYY-MM-DD`
            format. Requires `start_date` to be before `end_date`.
          schema:
            type: string
            format: date
            pattern: ^\d{4}-\d{2}-\d{2}$
        - name: resolution
          in: query
          required: true
          description: >-
            Sets the aggregation resolution. Allows at most 90 days for `day`,
            12 weeks for `week`, 12 months for `month`, and 4 quarters for
            `quarter`.
          schema:
            type: string
            enum:
              - day
              - week
              - month
              - quarter
        - name: filters
          in: query
          required: false
          style: deepObject
          explode: true
          description: >-
            Filters rows by field conditions, e.g.
            `filters[reward_id][conditions][$is]=lrew_...`.
          schema:
            $ref: '#/components/schemas/RewardsReportListFilters'
      responses:
        '200':
          description: Program rewards daily report.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/LoyaltiesProgramsReportsRewardsDailyListResponseBody
              examples:
                Daily rewards report:
                  value:
                    data:
                      - date: '2026-10-12'
                        reward_id: lrew_1294cebb458e4904a0
                        success_count: 1
                        failures_count: 0
                        failures_breakdown: {}
                        object: program_rewards_daily_report
                    object: report
                Empty rewards 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-131e4b76ad2e098921
                '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-131e4b76ad2e098922
                '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-131e4b76ad2e098923
                '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-131e4b76ad2e098924
                '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-131e4b76ad2e098925
                'Invalid query parameters: date range exceeds limit':
                  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-131e4b76ad2e098926
                '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-131e4b76ad2e098927
        '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_128f58429fc4bf7b2
                    request_id: v-131e4b76ad2e098928
                    resource_id: lprg_128f58429fc4bf7b2
                    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-131e4b76ad2e098929
                    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:
    RewardsReportListFilters:
      type: object
      description: Filters for program rewards reports.
      properties:
        junction:
          description: >-
            Sets the logical junction between the field filters. Defaults to
            `AND`.
          oneOf:
            - type: string
              enum:
                - AND
                - OR
            - type: 'null'
        reward_id:
          description: Filters by reward ID.
          oneOf:
            - $ref: '#/components/schemas/RewardsReportFilterRewardIdConditions'
            - type: 'null'
      additionalProperties: false
    LoyaltiesProgramsReportsRewardsDailyListResponseBody:
      type: object
      title: Loyalties Programs Reports Rewards Daily List Response Body
      description: >-
        Response body schema for **GET**
        `/v2/loyalties/programs/{programId}/reports/rewards/daily`.
      properties:
        data:
          type: array
          description: >-
            List of report entries, one per reward and aggregation period with
            recorded purchases, ordered by `date` ascending. Empty when no
            purchases were recorded in the range.
          items:
            $ref: '#/components/schemas/RewardsReportDailyEntry'
        object:
          type: string
          const: report
          description: Object type marker. Always `report`.
      required:
        - data
        - object
    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.
    RewardsReportFilterRewardIdConditions:
      type: object
      description: >-
        ID filter conditions for reward ID. Values must match pattern
        `^lrew_[a-f0-9]+$`. `$is` and `$is_not` accept a single value (string or
        1-element array). `$in` and `$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 reward ID equals the given value.
              oneOf:
                - type: string
                  pattern: ^lrew_[a-f0-9]+$
                - type: array
                  items:
                    type: string
                    pattern: ^lrew_[a-f0-9]+$
                  minItems: 1
                  maxItems: 1
                - type: 'null'
            $is_not:
              description: Matches rows whose reward ID does not equal the given value.
              oneOf:
                - type: string
                  pattern: ^lrew_[a-f0-9]+$
                - type: array
                  items:
                    type: string
                    pattern: ^lrew_[a-f0-9]+$
                  minItems: 1
                  maxItems: 1
                - type: 'null'
            $in:
              description: Matches rows whose reward ID is one of the given values.
              oneOf:
                - type: string
                  pattern: ^lrew_[a-f0-9]+$
                - type: array
                  items:
                    type: string
                    pattern: ^lrew_[a-f0-9]+$
                  minItems: 1
                  maxItems: 100
                - type: 'null'
            $not_in:
              description: Matches rows whose reward ID is not one of the given values.
              oneOf:
                - type: string
                  pattern: ^lrew_[a-f0-9]+$
                - type: array
                  items:
                    type: string
                    pattern: ^lrew_[a-f0-9]+$
                  minItems: 1
                  maxItems: 100
                - type: 'null'
      required:
        - conditions
      additionalProperties: false
    RewardsReportDailyEntry:
      type: object
      description: >-
        Aggregated reward-purchase counts for one period and reward. Counts that
        did not occur in the period are 0.
      properties:
        date:
          type: string
          format: date
          description: >-
            Identifies the start of the truncated aggregation period
            (`YYYY-MM-DD`). For `week` this is Monday. For `month` this is the
            first day. For `quarter` this is the quarter start.
        reward_id:
          type: string
          pattern: ^lrew_[a-f0-9]+$
          description: Identifies the reward (`lrew_...`).
        success_count:
          type: number
          description: Counts approved reward purchases in the period.
        failures_count:
          type: number
          description: Counts reward purchase attempts that failed in the period.
        failures_breakdown:
          type: object
          description: Always an empty object even if `failures_count` is above zero.
          additionalProperties: false
        object:
          type: string
          const: program_rewards_daily_report
          description: Object type marker. Always `program_rewards_daily_report`.
      required:
        - date
        - reward_id
        - success_count
        - failures_count
        - failures_breakdown
        - 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.