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

# List points activity

Returns points activity for a 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/points": {
      "get": {
        "summary": "List points activity",
        "description": "Returns points activity for a 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"
            }
          },
          {
            "$ref": "#/components/parameters/shopifyCustomerDigest"
          },
          {
            "in": "query",
            "name": "limit",
            "schema": {
              "type": "integer",
              "default": 10
            }
          },
          {
            "in": "query",
            "name": "nextToken",
            "schema": {
              "type": "string",
              "description": "The token returned by the previous call to this endpoint"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/pointActivity"
                      }
                    },
                    "nextToken": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "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."
      },
      "pointActivity": {
        "type": "object",
        "properties": {
          "shopId": {
            "type": "string"
          },
          "customerId": {
            "type": "string"
          },
          "action": {
            "type": "string"
          },
          "points": {
            "type": "integer"
          },
          "type": {
            "type": "string"
          },
          "shopifyPriceRuleId": {
            "type": "string"
          },
          "shopifyDiscountCodeId": {
            "type": "string"
          },
          "couponCode": {
            "type": "string"
          },
          "customerNote": {
            "type": "string"
          },
          "customDescription": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "updatedAt": {
            "type": "string"
          },
          "earnRuleId": {
            "type": "string"
          },
          "redeemRuleId": {
            "type": "string"
          },
          "rewardType": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "owner": {
            "type": "string"
          }
        }
      }
    }
  }
}
```