> ## 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 card daily points reports

> Returns aggregated points statistics for a member's loyalty card over the given date range and resolution. Each entry sums the point operations recorded in one period. Periods without recorded activity are omitted.

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`,
- `end_date` is inclusive.

Returns `400` when query validation fails. Returns `404` when the program or member does not exist, or when the card does not exist or is not assigned to the member in the program.



## OpenAPI

````yaml /openapi/loyalties-v2.json get /v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/reports/daily
openapi: 3.1.0
info:
  title: Voucherify Loyalty v2 API
  version: 2.0.0
  description: >-
    Complete OpenAPI specification for the Voucherify Loyalty v2 API.

    All endpoints require the LOYALTY_V2 feature flag.


    Combined from per-domain specs: programs.yaml, members.yaml,
    program-operations.yaml, card-definitions.yaml, earning-rules.yaml,
    tier-structures.yaml, benefits.yaml, rewards.yaml, examine.yaml
servers:
  - url: '{protocol}://{host}'
    variables:
      protocol:
        default: https
        enum:
          - https
          - http
      host:
        default: api.voucherify.io
security:
  - X-App-Id: []
    X-App-Token: []
  - bearerAuth: []
tags:
  - name: Programs
    description: >-
      Loyalty program CRUD, lifecycle management, program-scoped resource
      assignments (card definitions, earning rules, rewards, tier structures),
      member management (create, list, get, update, activate, deactivate,
      delete), membership retrieval (member + program + cards with tier
      progress, by customer ID, customer source ID, or member ID), card
      operations (points adjustment, pending points, expiring points,
      transactions), reward purchases, and activity history.
  - name: Card definitions
    description: >-
      CRUD operations, lifecycle management, and activity history for card
      definitions. Card definitions describe the configuration for loyalty
      cards, including code generation, points expiration, earning/spending
      limits, pending points, refunds, and balance settings.
  - name: Earning rules
    description: >-
      Manage earning rules that define how customers earn points or receive
      incentives based on triggers (events, segments, custom events). Includes
      CRUD, lifecycle, and activity history.
  - name: Tier structures
    description: >-
      CRUD operations, lifecycle management, and activity history for tier
      structures. Includes nested tier definitions (create, list, update,
      delete) within tier structures. Tier structures define the tiering model
      for loyalty programs - how members qualify for and move between tiers.
  - name: Benefits
    description: >-
      Manage benefit definitions (fixed points, proportional points, material,
      digital). Includes CRUD, lifecycle transitions, and activity history.
  - name: Rewards
    description: >-
      CRUD, lifecycle operations, and activity history for reward definitions.
      Rewards can be material (product/SKU) or digital (discount coupons, gift
      vouchers).
  - name: Examine
    description: >-
      Evaluation endpoints that estimate earning opportunities and reward
      availability for a customer across their loyalty program memberships,
      without side effects.
paths:
  /v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/reports/daily:
    parameters:
      - name: programId
        in: path
        required: true
        description: >-
          Unique loyalty program identifier (format: `lprg_` followed by
          hexadecimal characters).
        schema:
          type: string
          pattern: ^lprg_[a-f0-9]+$
      - name: memberId
        in: path
        required: true
        description: >-
          Unique loyalty member identifier (format: `lmbr_` followed by
          hexadecimal characters).
        schema:
          type: string
          pattern: ^lmbr_[a-f0-9]+$
      - name: cardId
        in: path
        required: true
        description: >-
          Unique loyalty card identifier (format: `lcrd_` followed by
          hexadecimal characters).
        schema:
          type: string
          pattern: ^lcrd_[a-f0-9]+$
    get:
      tags:
        - Programs
      summary: List card daily points reports
      description: >-
        Returns aggregated points statistics for a member's loyalty card over
        the given date range and resolution. Each entry sums the point
        operations recorded in one period. Periods without recorded activity are
        omitted.


        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`,

        - `end_date` is inclusive.


        Returns `400` when query validation fails. Returns `404` when the
        program or member does not exist, or when the card does not exist or is
        not assigned to the member in the program.
      operationId: listMemberCardDailyReports
      parameters:
        - name: start_date
          in: query
          required: true
          description: Start of the report date range (inclusive), 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: >-
            End of the report date range (inclusive), 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: >-
            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.
          schema:
            type: string
            enum:
              - day
              - week
              - month
              - quarter
      responses:
        '200':
          description: Card daily points report.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/LoyaltiesProgramsMembersCardsReportsDailyListResponseBody
              examples:
                'Card daily points report: Day resolution':
                  value:
                    data:
                      - date: '2026-07-01'
                        points_total: 0
                        points_earned: 0
                        points_added: 0
                        points_purchased: 0
                        points_purchased_reversed: 0
                        points_subtracted: 0
                        points_expired: 0
                        points_spent: 0
                        points_refunded: 0
                        points_returned: 0
                        points_locked: 0
                        points_unlocked: 0
                        pending_points_total: 7497
                        pending_points_activated: 0
                        pending_points_canceled: 0
                        object: card_daily_report
                      - date: '2026-07-11'
                        points_total: 7497
                        points_earned: 7497
                        points_added: 0
                        points_purchased: 0
                        points_purchased_reversed: 0
                        points_subtracted: 0
                        points_expired: 0
                        points_spent: 0
                        points_refunded: 0
                        points_returned: 0
                        points_locked: 0
                        points_unlocked: 0
                        pending_points_total: 0
                        pending_points_activated: 7497
                        pending_points_canceled: 0
                        object: card_daily_report
                      - date: '2026-07-16'
                        points_total: 0
                        points_earned: 0
                        points_added: 0
                        points_purchased: 0
                        points_purchased_reversed: 0
                        points_subtracted: 0
                        points_expired: 0
                        points_spent: 0
                        points_refunded: 0
                        points_returned: 0
                        points_locked: 0
                        points_unlocked: 0
                        pending_points_total: 1400
                        pending_points_activated: 0
                        pending_points_canceled: 0
                        object: card_daily_report
                      - date: '2026-07-26'
                        points_total: 1400
                        points_earned: 1400
                        points_added: 0
                        points_purchased: 0
                        points_purchased_reversed: 0
                        points_subtracted: 0
                        points_expired: 7497
                        points_spent: 0
                        points_refunded: 0
                        points_returned: 0
                        points_locked: 0
                        points_unlocked: 0
                        pending_points_total: 0
                        pending_points_activated: 1400
                        pending_points_canceled: 0
                        object: card_daily_report
                    object: report
                'Card daily points report: Week resolution':
                  value:
                    data:
                      - date: '2026-06-29'
                        points_total: 0
                        points_earned: 0
                        points_added: 0
                        points_purchased: 0
                        points_purchased_reversed: 0
                        points_subtracted: 0
                        points_expired: 0
                        points_spent: 0
                        points_refunded: 0
                        points_returned: 0
                        points_locked: 0
                        points_unlocked: 0
                        pending_points_total: 7497
                        pending_points_activated: 0
                        pending_points_canceled: 0
                        object: card_daily_report
                      - date: '2026-07-06'
                        points_total: 7497
                        points_earned: 7497
                        points_added: 0
                        points_purchased: 0
                        points_purchased_reversed: 0
                        points_subtracted: 0
                        points_expired: 0
                        points_spent: 0
                        points_refunded: 0
                        points_returned: 0
                        points_locked: 0
                        points_unlocked: 0
                        pending_points_total: 0
                        pending_points_activated: 7497
                        pending_points_canceled: 0
                        object: card_daily_report
                      - date: '2026-07-13'
                        points_total: 0
                        points_earned: 0
                        points_added: 0
                        points_purchased: 0
                        points_purchased_reversed: 0
                        points_subtracted: 0
                        points_expired: 0
                        points_spent: 0
                        points_refunded: 0
                        points_returned: 0
                        points_locked: 0
                        points_unlocked: 0
                        pending_points_total: 1400
                        pending_points_activated: 0
                        pending_points_canceled: 0
                        object: card_daily_report
                      - date: '2026-07-20'
                        points_total: 1400
                        points_earned: 1400
                        points_added: 0
                        points_purchased: 0
                        points_purchased_reversed: 0
                        points_subtracted: 0
                        points_expired: 7497
                        points_spent: 0
                        points_refunded: 0
                        points_returned: 0
                        points_locked: 0
                        points_unlocked: 0
                        pending_points_total: 0
                        pending_points_activated: 1400
                        pending_points_canceled: 0
                        object: card_daily_report
                    object: report
                'Card daily points report: Month resolution':
                  value:
                    data:
                      - date: '2026-07-01'
                        points_total: 8897
                        points_earned: 8897
                        points_added: 0
                        points_purchased: 0
                        points_purchased_reversed: 0
                        points_subtracted: 0
                        points_expired: 7497
                        points_spent: 0
                        points_refunded: 0
                        points_returned: 0
                        points_locked: 0
                        points_unlocked: 0
                        pending_points_total: 8897
                        pending_points_activated: 8897
                        pending_points_canceled: 0
                        object: card_daily_report
                    object: report
                'Card daily points report: Quarter resolution':
                  value:
                    data:
                      - date: '2026-07-01'
                        points_total: 8897
                        points_earned: 8897
                        points_added: 0
                        points_purchased: 0
                        points_purchased_reversed: 0
                        points_subtracted: 0
                        points_expired: 7497
                        points_spent: 0
                        points_refunded: 0
                        points_returned: 0
                        points_locked: 0
                        points_unlocked: 0
                        pending_points_total: 8897
                        pending_points_activated: 8897
                        pending_points_canceled: 0
                        object: card_daily_report
                    object: report
                'Card daily points report: No activity':
                  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-130eb43b3685e26454
                '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-130eb46d6c45e264b2
                '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-130eb4847405e264e3
                '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-130eb4847405e264e4
                '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-130eb43b3685e26455
                '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-130eb43b3685e26456
                '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-130eb43b3685e26457
        '404':
          description: Resource 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_28f58429f4c4bf7b2
                    request_id: v-131e61d450c264502d
                    resource_id: lprg_28f58429f4c4bf7b2
                    resource_type: program
                Member not found:
                  value:
                    code: 404
                    key: not_found
                    message: Resource not found
                    details: Cannot find member with id lmbr_128f9ee624c4ba553
                    request_id: v-131e61f4dcee09b660
                    resource_id: lmbr_128f9ee624c4ba553
                    resource_type: member
                Card not found or not assigned to the member:
                  value:
                    code: 404
                    key: not_found
                    message: Resource not found
                    details: Cannot find card with id lcrd_128f9ee63cc4ba558
                    request_id: v-131e61ff0dc2645083
                    resource_id: lcrd_128f9ee63cc4ba558
                    resource_type: card
        '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.
components:
  schemas:
    LoyaltiesProgramsMembersCardsReportsDailyListResponseBody:
      type: object
      title: Loyalties Programs Members Cards Reports Daily List Response Body
      description: >-
        Response body schema for **GET**
        `/v2/loyalties/programs/{programId}/members/{memberId}/cards/{cardId}/reports/daily`.
      properties:
        data:
          type: array
          description: >-
            List of report entries, one per aggregation period with recorded
            activity, ordered by `date` ascending. Empty when no activity was
            recorded in the range.
          items:
            $ref: '#/components/schemas/CardDailyReportEntry'
        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.
    CardDailyReportEntry:
      type: object
      description: >-
        Aggregated card points statistics for one period. Each field sums the
        operations of one kind recorded in the period. All numeric fields
        default to 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.
        points_total:
          type: number
          description: >-
            Points credited to the card in the period. Sums `points_earned`,
            `points_added`, and `points_purchased`. Points spent, expired,
            subtracted, refunded, returned, or reversed are not deducted.
        points_earned:
          type: number
          description: >-
            Points earned through earning rules in the period. Includes pending
            points activated in the period.
        points_added:
          type: number
          description: Points added manually in the period.
        points_purchased:
          type: number
          description: >-
            Points purchased (e.g. via loyalty-card-points rewards) in the
            period.
        points_purchased_reversed:
          type: number
          description: Purchased points reversed (e.g. by reward refunds) in the period.
        points_subtracted:
          type: number
          description: Points subtracted manually in the period.
        points_expired:
          type: number
          description: Points expired in the period.
        points_spent:
          type: number
          description: Points spent (on rewards and order payments) in the period.
        points_refunded:
          type: number
          description: Points refunded in the period.
        points_returned:
          type: number
          description: Points returned in the period.
        points_locked:
          type: number
          description: Points locked in the period.
        points_unlocked:
          type: number
          description: >-
            Points unlocked in the period. Includes points released when a
            spending transaction is approved (also counted in `points_spent`) or
            rejected.
        pending_points_total:
          type: number
          description: >-
            Pending points added in the period. Activated and canceled pending
            points are not deducted.
        pending_points_activated:
          type: number
          description: >-
            Pending points activated in the period. Also counted in
            `points_earned` and `points_total`.
        pending_points_canceled:
          type: number
          description: Pending points canceled in the period.
        object:
          type: string
          const: card_daily_report
          description: Object type marker. Always `card_daily_report`.
      required:
        - date
        - points_total
        - points_earned
        - points_added
        - points_purchased
        - points_purchased_reversed
        - points_subtracted
        - points_expired
        - points_spent
        - points_refunded
        - points_returned
        - points_locked
        - points_unlocked
        - pending_points_total
        - pending_points_activated
        - pending_points_canceled
        - 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

````