---
updatedAt: 2025-12-19T15:09:29.000Z
agentTools:
  projectIndex: https://loyaltyapi.yotpo.com/llms.txt
---

# Fetch VIP Tiers

Returns your program's configured VIP tiers, including each tier's ID — use it to display tier structure to customers or to look up the tier IDs other endpoints reference.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-settings",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://loyalty.yotpo.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "X-API-KEY": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY",
        "description": "Your account API key can be found in the \"Settings\" section of your Yotpo loyalty admin. See [Yotpo Authentication](https://loyaltyapi.yotpo.com/reference/authentication) to learn how to generate your API key."
      },
      "X-GUID": {
        "type": "apiKey",
        "in": "header",
        "name": "X-GUID",
        "description": "The Globally Unique Identifier found in the \"Settings\" section of your Yotpo loyalty admin. See [Yotpo Authentication](https://loyaltyapi.yotpo.com/reference/authentication) to learn how to generate your GUID."
      }
    }
  },
  "security": [
    {
      "X-API-KEY": [],
      "X-GUID": []
    }
  ],
  "paths": {
    "/api/v2/vip_tiers": {
      "get": {
        "summary": "Fetch VIP Tiers",
        "description": "Returns your program's configured VIP tiers, including each tier's ID — use it to display tier structure to customers or to look up the tier IDs other endpoints reference.",
        "operationId": "fetch-vip-tiers",
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "[\n    {\n    \"id\": 12593,\n    \"name\": \"Base Tier\",\n    \"description\": \"First Tier Every customer earn\",\n    \"points_multiplier\": \"1.0\",\n    \"type\": \"BaseTier\",\n    \"points_reward\": 0,\n    \"coupon_reward\": \"\",\n    \"entry_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 0,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0,\n    \"requirements_needed\": \"all_requirements\"\n        },\n    \"retain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 0,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        },\n    \"regain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 0,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        }\n    },\n    {\n    \"id\": 12594,\n    \"name\": \"TierA\",\n    \"description\": \"Spend $50 to Earn the tier\",\n    \"points_multiplier\": \"1.25\",\n    \"type\": \"VipTier\",\n    \"points_reward\": 50,\n    \"coupon_reward\": \"Tier A coupon reward $5\",\n    \"entry_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 5000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0,\n    \"requirements_needed\": \"all_requirements\"\n        },\n    \"retain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 5000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        },\n    \"regain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 5000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        }\n    },\n    {\n    \"id\": 12595,\n    \"name\": \"TierB\",\n    \"description\": \"Spend $100 to Earn the tier\",\n    \"points_multiplier\": \"1.5\",\n    \"type\": \"VipTier\",\n    \"points_reward\": 100,\n    \"coupon_reward\": \"Tier B coupon reward $10\",\n    \"entry_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 10000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0,\n    \"requirements_needed\": \"all_requirements\"\n        },\n    \"retain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 10000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        },\n    \"regain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 10000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        }\n    },\n    {\n    \"id\": 12596,\n    \"name\": \"TierC\",\n    \"description\": \"Spend $200 to Earn the tier\",\n    \"points_multiplier\": \"1.75\",\n    \"type\": \"VipTier\",\n    \"points_reward\": 200,\n    \"coupon_reward\": \"Tier C coupon reward 20%\",\n    \"entry_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 20000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0,\n    \"requirements_needed\": \"all_requirements\"\n        },\n    \"retain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 20000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        },\n    \"regain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 20000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        }\n    },\n    {\n    \"id\": 12597,\n    \"name\": \"TierD\",\n    \"description\": \"Spend $400 to Earn the tier\",\n    \"points_multiplier\": \"2.0\",\n    \"type\": \"VipTier\",\n    \"points_reward\": 200,\n    \"coupon_reward\": \"Tier D coupon Reward 30%\",\n    \"entry_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 40000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0,\n    \"requirements_needed\": \"all_requirements\"\n        },\n    \"retain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 40000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        },\n    \"regain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 40000,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        }\n    },\n    {\n    \"id\": 12598,\n    \"name\": \"Membership Tier\",\n    \"description\": \"Purchase Product 5560184602783 to earn the Tier\",\n    \"points_multiplier\": \"2.5\",\n    \"type\": \"VipTier\",\n    \"points_reward\": 500,\n    \"coupon_reward\": \"Tier Membership coupon reward $50\",\n    \"entry_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 0,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0,\n    \"requirements_needed\": \"all_requirements\"\n        },\n    \"retain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 0,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        },\n    \"regain_threshold\": {\n    \"points_earned\": 0,\n    \"amount_spent_cents\": 0,\n    \"purchases_made\": 0,\n    \"referrals_completed\": 0\n        }\n    }\n]"
                  }
                },
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer",
                        "example": 12593,
                        "default": 0
                      },
                      "name": {
                        "type": "string",
                        "example": "Base Tier"
                      },
                      "description": {
                        "type": "string",
                        "example": "First Tier Every customer earn"
                      },
                      "points_multiplier": {
                        "type": "string",
                        "example": "1.0"
                      },
                      "type": {
                        "type": "string",
                        "example": "BaseTier"
                      },
                      "points_reward": {
                        "type": "integer",
                        "example": 0,
                        "default": 0
                      },
                      "coupon_reward": {
                        "type": "string",
                        "example": ""
                      },
                      "entry_threshold": {
                        "type": "object",
                        "properties": {
                          "points_earned": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "amount_spent_cents": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "purchases_made": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "referrals_completed": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "requirements_needed": {
                            "type": "string",
                            "example": "all_requirements"
                          }
                        }
                      },
                      "retain_threshold": {
                        "type": "object",
                        "properties": {
                          "points_earned": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "amount_spent_cents": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "purchases_made": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "referrals_completed": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          }
                        }
                      },
                      "regain_threshold": {
                        "type": "object",
                        "properties": {
                          "points_earned": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "amount_spent_cents": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "purchases_made": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "referrals_completed": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "value": "application/json",
        "key": "Content-Type"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```