---
title: "Update a Customer's Tier Membership"
method: PATCH
path: "/wallet/{walletId}/tier/{tierId}/membership/{tierMembershipId}"
tags: ["Tier Membership"]
---

# Update a Customer's Tier Membership

`PATCH /wallet/{walletId}/tier/{tierId}/membership/{tierMembershipId}`

## Request

- Base URL: `https://wallet.sandbox.uk.eagleeye.com/2.0`
- URL: `https://wallet.sandbox.uk.eagleeye.com/2.0/wallet/{walletId}/tier/{tierId}/membership/{tierMembershipId}`
- Auth: none declared. Required headers: `X-EES-AUTH-CLIENT-ID`, `X-EES-AUTH-HASH`

This API allows a customer's Loyalty Account Tier Membership to be updated.

## Path parameters

- `walletId` string, required
- `tierId` string, required
- `tierMembershipId` string, required

## Headers

- `X-EES-AUTH-CLIENT-ID` string, string, required
- `X-EES-AUTH-HASH` string, string, required
- `Accept-Encoding` '' | 'gzip' | 'deflate' | 'gzip,deflate'
- `X-EES-TRANSACTION-ID` string, string
- `X-EES-RETRY` string, string

## Request body

- union
  - object
    - `expiryDate` string, required: DateTime in ATOM format.
    - `tierBalancesResetDate` string: DateTime in ATOM format.
  - object
    - `expiryDate` string: DateTime in ATOM format.
    - `tierBalancesResetDate` string, required: DateTime in ATOM format.

## Response `200`

The Tier Membership entity which defines the current state of a customer's Tier Membership.

- TierMembershipEntity
  - `tierMembershipId` string, required: The unique ID for this Tier Membership. This will be a numeric string value of variable length.
  - `tierId` string, required: The ID for the Tier Membership to which the customer belongs. This will be a numeric string value of variable length.
  - `status` 'ACTIVE', required: The status of this Tier Membership.
  - `accountIds` string[], required
  - `balances` TierMembershipBalancesEntity, required
    - `transactions` integer: The value representing the Tier Membership Balance for a customer's Tier Membership relating to the number of Tier Membership Transactions completed.
    - `spend` integer: The value representing the Tier Membership Balance for a customer's Tier Membership relating to the Tier Membership Spend amount completed.
    - `points` integer: The value representing the Tier Membership Balance for a customer's Tier Membership showing the Tier Membership Points earned.
  - `expiryDate` string, required: DateTime in ATOM format.
  - `tierBalancesResetDate` string, required: DateTime in ATOM format.
  - `dateCreated` string, required: DateTime in ATOM format.
  - `lastUpdated` string, required: DateTime in ATOM format.

## Other responses

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

---

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