CustomerHistory2

Returns history of events affecting the given customer, optionally filtered by time and area (points, tiers, achievements, votes, etc).

Kind	Read API call
Method	GET or POST
URL	https://app.bubblehouse.com/api/v20230601/<shop>/CustomerHistory2
Authentication	Customer TokenShop Token

Input

• customer CustomerIdentity1 required if using a shop token

  A customer to operate upon, when using a shop token.

  If you're using a customer token and decide to pass this field (which we do not recommend), it must match the customer from the token.

• only_unused boolean optional

  If true, only returns history entries with unused discount codes.

• only_points boolean optional

  If true, only returns history entries affecting the loyalty points.

Output

• changes array of Change2 required

  The customer's change history, optionally filtered according to the input parameters.

API-wide Errors

Status	Error	Reason & Examples
404	customer_identity_partially_mismatches_matched_customer	A customer has been matched by one of the fields of the customer identity ('customer' input parameter), but some non-empty fields do not match Bubblehouse data on that customer.
400	missing_customer_identity	The customer identity ('customer' input parameter) has not been specified when using a shop token. You need to either specify a non-empty value for one of the customer identity fields, or use a customer token.
404	empty_customer_identity	All fields of the customer identity ('customer' input parameter) have been empty when using a shop token. You need to either specify a non-empty value for one of the customer identity fields, or use a customer token.
403	customer_identity_does_not_match_token	API call is using a customer token, but the customer identity in API params does not match the customer from the token.
404	no_customers_match_customer_identity	The customer identity ('customer' input parameter) does not match a known customer.

Global Errors

Status	Error	Reason & Examples
429	rate_limit_exceeded	Your usage is over the rate limit. Ensure that you're not making duplicate calls, and contact our team for a rate limit increase.
400	invalid_global_api_version	The global API version you are trying to use has never existed.
400	obsolete_global_api_version	The global API version you are trying to use is no longer supported.
400	inaccessible_global_api_version	The global API version you are trying to use is not enabled on your account.
401	invalid_token	The provided authentication token is invalid or has expired.