---
title: "Get Merchant Metrics"
method: GET
path: "/v2/merchants/{merchant_id}/metrics"
tags: ["Merchants"]
---

# Get Merchant Metrics

`GET /v2/merchants/{merchant_id}/metrics`

## Request

- Base URL: `https://api.loyalty.dog`
- URL: `https://api.loyalty.dog/v2/merchants/{merchant_id}/metrics`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/loyalty/apis/loyaltydog/docs/v2/merchants/:merchant_id/metrics/get.ts> (a function with typed inputs; its response is checked against the schema)

Get metrics for a merchant's loyalty program.

### Args:
- `merchant_id`: The ID of the merchant (program)
- `period`: The time period for metrics (7d, 30d, 90d, custom)
- `user`: The authenticated user

### Returns:
- MetricsResponse with program metrics and trends

## Path parameters

- `merchant_id` string, required

## Query parameters

- `period` string

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- MetricsResponse
  - `activeMembers` integer, required
  - `redemptions` integer, required
  - `engagementRate` number, required
  - `pointsIssued` integer, required
  - `currencyEquivalent` number, required
  - `trends` MetricsTrend, required
    - `activeMembers` number, required
    - `redemptions` number, required
    - `engagementRate` number, required
    - `pointsIssued` number, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/loyalty/apis/loyaltydog.md) - [All operations](https://skmtc.dev/loyalty/apis/loyaltydog/llms.txt) - [OpenAPI document](https://skmtc.dev/loyalty/apis/loyaltydog/revisions/5803242b0551?raw)