---
title: "Search for Tiers"
method: GET
path: "/tiers"
tags: ["Tiers"]
---

# Search for Tiers

`GET /tiers`

This method allows the calling application to search Loyalty Tiers using query parameters.

## Query parameters

- `id` string, Int64
- `status` 'ACTIVE'
- `type` 'STANDARD'
- `reference` string
- `schemeId` string, Int64
- `promotionTierId` string, Int64
- `demotionTierId` string, Int64
- `offset` integer
- `limit` integer
- `orderBy` 'id,ASC' | 'id,DESC'

## 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

## Response `200`

OK.

- TiersSearchResponseEntity
  - `offset` integer — The number of Loyalty Tiers skipped when returning the data.
  - `limit` integer — The number of Loyalty Tiers limited in the results, up to a maximum of 100.
  - `total` integer — The total number of LoyaltyTiers matching your search.
  - `orderBy` object[] — How the results from your search were ordered.
    - `name` string — What column is being used to order.
    - `order` 'ASC' | 'DESC' — Whether the results are ordered ascending or descending.
  - `results` TierResponseEntity[] — The list of Loyalty Tiers that match your search.
    - `id` Id — unresolved $ref
    - `type` Type — unresolved $ref
    - `status` Status — unresolved $ref
    - `reference` Reference — unresolved $ref
    - `details` Details — unresolved $ref
    - `settings` TierSettings
      - `schemeOverrides` TierSchemeOverrides
        - `earnRates` object, nullable — Points spend rates for the Tier. The property keys of this object are the unit safe name for the default/parent unit and the incoming identifiers for any child units.
        - `expiryPoints` object
          - `enabled` boolean
          - `rule` object
            - `type` 'NEVEREXPIRE', required
      - `promotion` object
        - `promotionTierId` string, nullable — The ID of the Loyalty Tier the current Tier promotes to.
        - `ruleSets` TierRuleSets[] — The sets of rules which allow promotion to another Loyalty Tier.
          - `rules` TierRule[] — The Rules which must all be satisfied for this Ruleset to qualify for promotion.
            - `amount` integer
            - `balanceType` 'POINTS' | 'SPEND' | 'TRANSACTIONS'
      - `demotion` object
        - `demotionTierId` string, nullable — The ID of the Loyalty Tier the current Tier demotes to.
        - `balanceResetPeriod` TierResetPeriod
          - `periodOffset` object, nullable — The amount of time between Tier periods.
            - `periods` integer, required
            - `periodType` 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
          - `roundingRule` 'endOfMonth' | 'endOfQuarter' | 'endOfHalf' | 'endOfYear', nullable — The rounding rule to follow when calculating Tier periods.
        - `membershipExpiryPeriod` TierResetPeriod
          - `periodOffset` object, nullable — The amount of time between Tier periods.
            - `periods` integer, required
            - `periodType` 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
          - `roundingRule` 'endOfMonth' | 'endOfQuarter' | 'endOfHalf' | 'endOfYear', nullable — The rounding rule to follow when calculating Tier periods.
        - `reevaluateTierOnBalanceDebit` ReevaluateTierOnBalanceDebit — Configuration for whether a customer's Tier should be re-evaluated following a membership balance debit. If ommitted, this setting will be `enabled=false` by default.
          - `enabled` boolean — If enabled then a customer's Tier will be demoted if a refund takes their membership balance below all of the promotion Rulesets of their current Tier.
    - `dateCreated` DateCreated — unresolved $ref
    - `lastUpdated` LastUpdated — unresolved $ref

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `405` — Method Not Allowed.
- `429` — Too Many Requests
- `500` — Server Error
- `501` — Not Implemented
- `502` — Bad Gateway
- `503` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.dev/eagleeye/apis/wallet-api.md) · [All operations](https://skmtc.dev/eagleeye/apis/wallet-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eagleeye/wallet-api/revisions/90a122bb14cc/schema)