---
title: "Retrieve Available Loyalty Points"
method: GET
path: "/wallet/{walletId}/account/{accountId}/points/available"
tags: ["Accounts"]
---

# Retrieve Available Loyalty Points

`GET /wallet/{walletId}/account/{accountId}/points/available`

## Request

- Base URL: `https://wallet.uk.eagleeye.com/2.0`
- URL: `https://wallet.uk.eagleeye.com/2.0/wallet/{walletId}/account/{accountId}/points/available`
- Auth: API key in header `X-EES-AUTH-CLIENT-ID` and API key in header `X-EES-AUTH-HASH`

This API method allows calling applications to retrieve detailed information about how a customers points will expire. This end point is only applicable to schemes where Points Expiry is enabled. The response is a date organised list for the dates on which the points expire, and the value of the points on that date.

## Path parameters

- `walletId` string, string, required
- `accountId` string, string, required

## Query parameters

- `orderBy[]` string, string

## Response `200`

OK

- object
  - `limit` integer: The maximum number of transactions that were considered.
  - `total` integer: Total number of results in this response.
  - `totalRecords` integer: Total number of records used to calculate the results.
  - `offset` integer: Pagination Offset
  - `orderBy` object[]: Order by criteria.
    - `name` string: Field name used as a sorting key
    - `order` 'ASC' | 'DESC': Sorting direction.
  - `results` AccountPointsAvailableEntity[]: Array of accountPointsAvailableEntities
    - `points` integer: This is a batch of points to be expired at a specific date.
    - `records` integer: The number of records evaluated in order to calculate these results.
    - `validTo` string: This is the expiry date for this specific batch of points.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `415`: Unsupported Media Type
- `423`: Locked
- `429`: Too Many Requests
- `500`: Server Error

## Changes

- **2026-11-03** `7bc73e06813c`: 1 breaking, 33 warning, 13 info
  - the response's body type changed from no type to `object` for status `401`
  - added the new `AALR` enum value to the `allOf[#/components/schemas/defaultErrorEntity]/errorCode` response property for the response status `415`
  - added the new `AALR` enum value to the `allOf[#/components/schemas/defaultErrorEntity]/errorCode` response property for the response status `423`
  - added the new `AALR` enum value to the `allOf[#/components/schemas/defaultErrorEntity]/errorCode` response property for the response status `500`
  - …43 more
  - …this revision’s changelog is incomplete

[Operation history](https://skmtc.dev/eagleeye/apis/wallet-api/changes/wallet/:walletId/account/:accountId/points/available/get.md)

---

[API](https://skmtc.dev/eagleeye/apis/wallet-api.md) - [All operations](https://skmtc.dev/eagleeye/apis/wallet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eagleeye/apis/wallet-api/revisions/7bc73e06813c?raw)