---
title: "Verify the balance of a gift card"
method: GET
path: "/v1/giftcards/{giftcard_number}/balance"
---

# Verify the balance of a gift card

`GET /v1/giftcards/{giftcard_number}/balance`

## Request

- Base URL: `https://api.zenoti.com`
- URL: `https://api.zenoti.com/v1/giftcards/{giftcard_number}/balance`
- Auth: none required
- TypeScript: <https://skmtc.dev/zenoti/apis/zenoti-authentication/docs/v1/giftcards/:giftcard_number/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

This API helps you to verify the balance of a guest's Zenoti gift card.

If the guest's gift card contains sufficient balance, you can redeem the gift card to collect payment for an invoice.

You must specify appropriate data for the `giftcard_number` parameter.

## Path parameters

- `giftcard_number` string, required

## Response `200`

200

- object
  - `balance` integer
  - `user_id` string
  - `expiry` string
  - `type` string
  - `status` string
  - `error` object
    - `code` integer
    - `message` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/zenoti/apis/zenoti-authentication.md) - [All operations](https://skmtc.dev/zenoti/apis/zenoti-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/zenoti/apis/zenoti-authentication/revisions/e628f892391a?raw)