Get Customer

Retrieve essential customer information from Gameball using a unique customerId. Returns general customer info (no personal data) with the public key.

get/api/v4.0/integrations/customers/{customerId}

Path parameters

customerIdstring required

Unique identifier for the customer

Response

Customer found

gameballIdnumber

The customer's unique ID within the Gameball system

customerIdstring

Unique identifier for the customer

referralCodestring

The referral code of the customer

referralLinkstring

The referral link generated for the customer

isReferredboolean

Boolean indicating if this customer was referred

dynamicReferralLinkstring

Dynamic referral link for mobile apps

Changes

Changed in 5 of the 38 revisions of this API.1324

Dec 21, 202504ddd9941f0115See the full diff
- ○
  added the optional property customerAttributes/city to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/country to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/custom to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/devices to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/gender to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/lastOrderDate to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/manualDate to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/paymentMethods to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/tags to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/totalOrders to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/totalSpent to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/utMs to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/utms to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property customerAttributes/zip to the response with the 200 status
  response-optional-property-added
Sep 30, 20257887186517671See the full diff
- ○
  removed the non-success response with the status 404
  response-non-success-status-removed
Sep 16, 20259982cd425d6b37See the full diff
- ●
  removed the optional property attributes from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property email from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property mobile from the response with the 200 status
  response-optional-property-removed
- ○
  api operation id getCustomer was added
  api-operation-id-added
- ○
  added the optional property customerAttributes to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property dynamicReferralLink to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property gameballId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property isReferred to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property referralCode to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property referralLink to the response with the 200 status
  response-optional-property-added
Sep 8, 202574802d3d15e71See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 2, 2025919eb7a392aa1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 38 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history