---
title: "Get Analytics Trends"
method: GET
path: "/v2/giftcards/programs/{programId}/analytics/trends"
tags: ["Gift Card Analytics"]
---

# Get Analytics Trends

`GET /v2/giftcards/programs/{programId}/analytics/trends`

Return time-series transaction data bucketed by *granularity*.

The aggregation groups transactions by day in MongoDB, then Python
re-buckets the daily totals into week/month windows.  This avoids
MongoDB version-specific ``$dateTrunc`` syntax.

## Path parameters

- `programId` string, required

## Query parameters

- `period` string, nullable
- `granularity` string
- `from` string, nullable
- `to` string, nullable
- `cardId` string

## Headers

- `X-Eposn-Customer-Token` string, nullable
- `X-Eposn-Merchant-Token` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/loyalty/apis/loyaltydog.md) · [All operations](https://skmtc.net/loyalty/apis/loyaltydog/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loyalty/loyaltydog/versions/42b7b22af2b6/schema)