---
title: "Fetch a guest's loyalty points"
method: GET
path: "/guests/{guestId}/loyalty-points"
tags: ["Loyalty Program"]
---

# Fetch a guest's loyalty points

`GET /guests/{guestId}/loyalty-points`

## Request

- Base URL: `https://api.liteapi.travel/v3.0`
- URL: `https://api.liteapi.travel/v3.0/guests/{guestId}/loyalty-points`
- Auth: API key in header `X-API-Key`

## Overview

Get a guest's current available points and upcoming points (points pending from confirmed bookings).

## When to Use

- **Points display** - Show points balance on guest account pages
- **Points checking** - Quick lookup of available points
- **Pending points** - Display points that will be awarded after stays
- **Balance verification** - Verify points before redemption

## What You Get

- **Current points** - Points available for immediate redemption
- **Upcoming points** - Points that will be awarded from confirmed bookings

## Quick Start

Provide the guest ID in the URL path. Returns both current and upcoming points balances.

## Path parameters

- `guestId` integer, required

## Response `200`

OK

- object
  - `data` object
    - `currentPoints` integer
    - `upcomingPoints` integer

## Other responses

- `400`: Bad Request

---

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