---
title: "Read rewards"
method: GET
path: "/api/agent/v1/rewards/balance"
tags: ["Rewards"]
---

# Read rewards

`GET /api/agent/v1/rewards/balance`

## Request

- Base URL: `https://vaanzari.com`
- URL: `https://vaanzari.com/api/agent/v1/rewards/balance`
- Auth: OAuth 2 (authorization code, authorization URL `https://vaanzari.com/oauth/authorize`, token URL `https://vaanzari.com/oauth/token`, scopes: `rewards.read`)

Returns authorized customer points balance and recent transactions.

## Response `200`

Rewards balance.

- object
  - `balance` number, required
  - `lifetime_earned` number
  - `lifetime_redeemed` number
  - `transactions` object[], required

## Other responses

- `401`: Structured API error.

---

[API](https://skmtc.dev/vaanzari/apis/vaanzari-agent-and-catalogue-api.md) · [All operations](https://skmtc.dev/vaanzari/apis/vaanzari-agent-and-catalogue-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vaanzari/apis/vaanzari-agent-and-catalogue-api/revisions/1a8cc2dbe711?raw)