Skip to main content
LoyaltyDog exposes both endpoint-driven and dashboard-driven reporting. This guide covers the API surface.

​
What’s available

Endpoint familyWhat it tells you
GET /v2/merchants/{id}/metricsHigh-level merchant-wide KPIs
GET /v2/merchants/{id}/metrics/chartTime-series data for the merchant dashboard
GET /v2/reportsPer-program reports (transactions, customers, gift card activity)
See the API reference for full parameter and response details.

​
Common patterns

​
Daily snapshot

Schedule a daily job that pulls metrics and pipes them into your BI tool: 
curl -sS "$LOYALTYDOG_API_URL/merchants/$MERCHANT_ID/metrics?period=24h" \
  -H "Authorization: Bearer $LOYALTYDOG_API_TOKEN"

​
Time-series for a custom dashboard

curl -sS "$LOYALTYDOG_API_URL/merchants/$MERCHANT_ID/metrics/chart?metric=points_awarded&period=30d&granularity=day" \
  -H "Authorization: Bearer $LOYALTYDOG_API_TOKEN"

​
Best practices

  • Cache aggressively. Reports are eventually consistent — minute-level freshness is more than enough for most dashboards.
  • Page through large reports. Use the limit and cursor parameters where supported.
  • For real-time, prefer webhooks. Polling reports is the wrong tool when you need event-level reaction. See Webhooks.