---
title: "Get a reward tier"
method: GET
path: "/v1/loyalty/reward-tiers/{id}"
tags: ["Loyalty"]
---

# Get a reward tier

`GET /v1/loyalty/reward-tiers/{id}`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/loyalty/reward-tiers/{id}`
- Auth: API key in header `X-Api-Key`

Fetch details of a specific loyalty reward tier, including visit thresholds, accrual ratio, and branding.

## Path parameters

- `id` string, uuid, required

## Response `200`

Loyalty reward tier retrieved successfully

- LoyaltyRewardTierDto
  - `id` string, uuid, required: Entity UUID
  - `createdAt` string, date-time, required: Creation date (ISO 8601)
  - `updatedAt` string, date-time, required: Last update date (ISO 8601)
  - `application` string, uuid, required: The unique identifier of the application
  - `name` string, required: The name of the loyalty reward tier
  - `requiredVisits` integer, required: The number of visits required to reach this reward tier
  - `currencyToPointRatio` integer, required: Number of loyalty points earned for each 1 unit of currency spent (e.g., if the ratio is 2 and currency is EUR, spending €1 earns 2 points). Used to calculate point accruals from transaction amounts.
  - `bgImageUrl` string, uri, nullable: Background image for the reward tier. Supported formats: WEBP (preferred), PNG. Recommended size: 1920×1080 px (landscape). Max file size: 1 MB.

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)