Skip to main content
GET
/
api
/
v4.0
/
integrations
/
customers
/
{customerId}
/
details
Get Customer Details
curl --request GET \
  --url https://api.gameball.co/api/v4.0/integrations/customers/{customerId}/details \
  --header 'apikey: <api-key>' \
  --header 'secretkey: <api-key>'
{
  "customerId": "<string>",
  "gameballId": 123,
  "customerAttributes": {
    "displayName": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "email": "<string>",
    "gender": "<string>",
    "mobile": "<string>",
    "dateOfBirth": "<string>",
    "joinDate": "<string>",
    "country": "<string>",
    "city": "<string>",
    "zip": "<string>",
    "preferredLanguage": "<string>",
    "tags": [
      "<string>"
    ],
    "source": "<string>",
    "utms": "<array>",
    "utMs": "<array>",
    "devices": "<array>",
    "paymentMethods": [
      "<string>"
    ],
    "totalSpent": 123,
    "lastOrderDate": "<string>",
    "totalOrders": 123,
    "avgOrderAmount": 123,
    "custom": {},
    "manualDate": "<string>"
  },
  "referralCode": "<string>",
  "referralLink": "<string>",
  "isReferred": true,
  "dynamicReferralLink": "<string>"
}
This API provides access to comprehensive customer information in Gameball, including personally identifiable information (PII), using a unique customerId. Secured by a secret key, this endpoint ensures that sensitive customer data remains protected, offering a complete view of the customer profile for more personalized and secure interactions.
Security: Requires apikey and secretkey headers.

Authorizations

​
apikey
string
header
required
​
secretkey
string
header
required

Path Parameters

​
customerId
string
required

Unique identifier for the customer

Response

200 - application/json

Customer details found

​
customerId
string

Unique identifier for the customer

​
gameballId
number

The customer's unique ID within the Gameball system

​
customerAttributes
object

Complete customer attributes including PII

​
referralCode
string

The referral code of the customer

​
referralLink
string

The referral link generated for the customer

​
isReferred
boolean

Boolean indicating if this customer was referred

​
dynamicReferralLink
string

Dynamic referral link for mobile apps