---
updatedAt: 2025-03-06T22:38:41.000Z
agentTools:
  projectIndex: https://developer.influence.io/llms.txt
---

# List redeem rules

Returns shop redeem rules

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Influence.io Launcher API",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://launcher.api.influence.io/launcher"
    }
  ],
  "paths": {
    "/v1/shop/rules/redeem": {
      "get": {
        "summary": "List redeem rules",
        "description": "Returns shop redeem rules",
        "parameters": [
          {
            "in": "query",
            "name": "shop",
            "description": "Your shop key",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "reward_type",
            "description": "Optional filter for specific reward types. Available values: Free shipping, Fixed amount discount, Percentage discount, Point donation, Product discount, Gift card, Subscription Free Shipping, Subscription Fixed amount discount, Subscription Percentage discount, POS amount discount, POS percentage discount, POS product discount.",
            "schema": {
              "type": "string",
              "enum": [
                "freeshipping",
                "amountdiscount",
                "fixedamountdiscount",
                "percentageoff",
                "pointdonation",
                "productdiscount",
                "giftcard",
                "subscriptionfreeshipping",
                "subscriptionfixedamountdiscount",
                "subscriptionpercentageoff",
                "pos_amountdiscount",
                "pos_percentageoff",
                "pos_productdiscount"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "rules": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/redeemRule"
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Shop not found with shopKey"
          }
        },
        "tags": [
          "shop"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "product": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique Influence.io UUID for a shop"
          },
          "title": {
            "type": "string"
          },
          "externalId": {
            "type": "string"
          },
          "imageUrl": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "referralStatus": {
            "type": "string"
          },
          "externalUrlHandle": {
            "type": "string"
          },
          "tierStatus": {
            "type": "string"
          }
        }
      },
      "productVariant": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique Influence.io UUID for a shop"
          },
          "title": {
            "type": "string"
          },
          "externalVariantId": {
            "type": "string"
          },
          "externalProductId": {
            "type": "string"
          },
          "imageUrl": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "position": {
            "type": "integer"
          }
        }
      },
      "redeemRule": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique Influence.io UUID for the redeem rule"
          },
          "title": {
            "type": "string"
          },
          "customTitle": {
            "type": "string"
          },
          "pointCost": {
            "type": "integer"
          },
          "discountValue": {
            "type": "integer"
          },
          "templateName": {
            "type": "string"
          },
          "redeemType": {
            "type": "string"
          },
          "maxRedeemablePoints": {
            "type": "integer"
          },
          "minRedeemablePoints": {
            "type": "integer"
          },
          "minSpendAmount": {
            "type": "integer"
          },
          "status": {
            "type": "string"
          },
          "product": {
            "$ref": "#/components/schemas/product"
          },
          "variants": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/productVariant"
            }
          }
        }
      }
    }
  }
}
```