---
title: "Get Reward Bank Links"
method: GET
path: "/wallet/{walletId}/bank/pointsreward/links"
tags: ["Links"]
---

# Get Reward Bank Links

`GET /wallet/{walletId}/bank/pointsreward/links`

## Request

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

This API method allows the calling application to retrieve a list of links between a requested Wallet, identified by a Wallet ID, and a `PRIVATE` Reward Banks (of type Points Reward). Optionally this endpoint would perform a result filtering, if an appropriate query strings parameters are passed in.

## Path parameters

- `walletId` string, string, required

## Query parameters

- `status` string, string
- `state` string, string
- `validFrom` string, string
- `validTo` string, string
- `orderBy[]` string, string

## Headers

- `x-client-transaction-time` string, string

## Response `200`

OK

- object
  - `offset` integer, required: Pagination Offset
  - `limit` integer, required: Pagination Limit
  - `orderBy` object[], required
    - `name` string, string, required: Sort by column
    - `order` 'ASC' | 'DESC', required: Sorting order
  - `total` integer, required: Result set count
  - `results` PointsrewardBankWalletLinkEntity[], required
    - `pointsRewardBankWalletLinkId` string, string, required: EES AIR Link ID
    - `walletId` string, string, required: EES AIR Wallet ID
    - `pointsRewardBankId` string, string, required: EES AIR Reward Bank ID
    - `pointsRewardBankRewardId` string, string, required: Reward ID
    - `type` string, string, required: Link Type - please refer to your Wallet Config document as available for each Client enum values for this field, and their meaning should be documented there
    - `status` 'ACTIVE' | 'USED' | 'EXPIRED' | 'CANCELLED' | 'DELETED', required: Link Status
    - `state` string, string, required: Link state - - please refer to your Wallet Config document as available for each Client enum values for this field, and their meaning should be documented there
    - `validFrom` string, ees-date-time, required: Link Validity-From a Date-time (ATOM format)
    - `validTo` string, ees-date-time, required: Link Validity-To a Date-time (ATOM format)
    - `dateCreated` string, ees-date-time, required: Link Creation Date-time (ATOM format)
    - `lastUpdated` string, ees-date-time, required: Link last update Date-time (ATOM format)

## Other responses

- `400`: Bad Request
- `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`: 2 breaking, 33 warning, 16 info
  - the response's body type changed from no type to `object` for status `400`
  - 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`
  - …47 more
  - …this revision’s changelog is incomplete

[Operation history](https://skmtc.dev/eagleeye/apis/wallet-api/changes/wallet/:walletId/bank/pointsreward/links/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)