---
title: "Retrieve a calculated rewards balance for a specified customer."
method: GET
path: "/api/v1alpha1/customers/{customerId}/balance"
tags: ["RewardsService"]
---

# Retrieve a calculated rewards balance for a specified customer.

`GET /api/v1alpha1/customers/{customerId}/balance`

This endpoint is designed to provide a detailed customer balance.

The response includes pertinent information about the customer balance, such as: unavailable balance, available balance, next purchase available balance and the first due date for next purchase value.

For now, we will return only the description of the campaign related to rewards availables on next purchase.

## Path parameters

- `customerId` string, required

## Query parameters

- `storeId` string

## Headers

- `Brand` string, required

## Response `200`

A successful response.

- V1alpha1GetCustomerBalanceResponse
  - `unavailableBalance` string
  - `availableBalance` string — Amount of cashback that is available to be consumed.
  - `nextPurchaseBalance` string — Amount of cashback that is available for the next purchase based on redemption rules.
  - `nextPurchaseFirstDueDate` string, date-time — First due date of the rewards that make up the balance of the next purchase.
  - `campaign` V1alpha1Campaign
    - `id` integer — ID of the campaign that generated the reward.
    - `name` string — Name of the campaign that generated the reward.
    - `description` string — Description of the campaign that generated the reward.

## Other responses

- `400` — When an invalid request is sent.
- `401` — When the authentication is failed.
- `403` — when it was not authorized.
- `default` — An unexpected error response.

---

[API](https://skmtc.dev/dito/apis/authentication-api.md) · [All operations](https://skmtc.dev/dito/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dito/authentication-api/revisions/de4a5e2a412f/schema)