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

# Get all active rewards

Returns information about the customer

# 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/customer/all-rewards": {
      "get": {
        "summary": "Get all active rewards",
        "description": "Returns information about the customer",
        "parameters": [
          {
            "in": "query",
            "name": "customer_id",
            "schema": {
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "customer_email",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "shop",
            "description": "Your shop key",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "type",
            "description": "Optional filter for reward types. Available values: PointActivity, CustomerLoyaltyTierEntryReward, ReferralReward",
            "schema": {
              "type": "string",
              "enum": [
                "PointActivity",
                "CustomerLoyaltyTierEntryReward",
                "ReferralReward"
              ]
            }
          },
          {
            "in": "query",
            "name": "limit",
            "description": "Optional limit for the number of rewards to return. Default is 10.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "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"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/shopifyCustomerDigest"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/reward"
                      }
                    },
                    "nextToken": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400ShopifyCustomerDigestBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401ShopifyCustomerDigestDigestMismatch"
          }
        },
        "tags": [
          "customer"
        ]
      }
    }
  },
  "components": {
    "parameters": {
      "shopifyCustomerDigest": {
        "in": "query",
        "name": "digest",
        "description": "An HMAC digest created by concatenating the Shopify customer ID, customer email and your shop key, using your API secret at the key. Refer to the digest schema for more information",
        "schema": {
          "$ref": "#/components/schemas/digest"
        }
      }
    },
    "responses": {
      "400ShopifyCustomerDigestBadRequest": {
        "description": "Shop not found",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "string",
                  "enum": [
                    "ShopRequired",
                    "CustomerRequired"
                  ]
                }
              }
            }
          }
        }
      },
      "401ShopifyCustomerDigestDigestMismatch": {
        "description": "This response is return if either the shop is not found, the customer is not found or the digest is mismatched. The exact reason for digest matching failing is not given for security reasons.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "string",
                  "enum": [
                    "DigestMismatch"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "schemas": {
      "digest": {
        "type": "string",
        "description": "An HMAC digest created by concatenating the Shopify customer ID, customer email and your shop key, using your API secret at the key. If you are using the \"Headless\" widget, you can access the `data-customer-digest` property that is automatically generated when a customer logs into your Shopify store."
      },
      "reward": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "customerId": {
            "type": "string"
          },
          "couponCode": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "pointsSpent": {
            "type": "integer"
          },
          "type": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          },
          "rewardType": {
            "type": "string"
          },
          "productApplicability": {
            "type": "string",
            "enum": [
              "OneTimePurchase",
              "Subscription",
              "Both"
            ]
          }
        }
      }
    }
  }
}
```