---
title: "Get Customer"
method: GET
path: "/api/v4.0/integrations/customers/{customerId}"
---

# Get Customer

`GET /api/v4.0/integrations/customers/{customerId}`

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

## Path parameters

- `customerId` string, required

## Response `200`

Customer found

- CustomerResponse
  - `gameballId` number — The customer's unique ID within the Gameball system
  - `customerId` string — Unique identifier for the customer
  - `customerAttributes` object — Customer attributes (minimized, excluding PII)
    - `gender` string — Customer's gender.
    - `country` string — Customer's country.
    - `city` string — Customer's city.
    - `zip` string — Customer's postal code.
    - `custom` object — Key-value pairs that allow you to store additional attributes for the customer. This can include any extra information specific to your needs, enabling more personalized interactions and offerings.
    - `tags` string[] — Tags associated with the customer.
    - `source` string — Source of the customer registration.
    - `utMs` unknown[] — List of UTM attributes associated with the customer.
      - unknown
    - `utms` unknown[] — List of UTM attributes associated with the customer.
      - unknown
    - `devices` unknown[] — List of devices associated with the customer.
      - unknown
    - `paymentMethods` string[] — List of payment methods used by the customer.
    - `totalSpent` number — Total amount spent by the customer.
    - `lastOrderDate` string — Date of the last order placed by the customer.
    - `totalOrders` number — Total number of orders placed by the customer.
    - `manualDate` string — Custom date for manual entries.
  - `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

---

[API](https://skmtc.net/gameballers/apis/gameball-api.md) · [All operations](https://skmtc.net/gameballers/apis/gameball-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gameballers/gameball-api/versions/2e4a8bfe2291/schema)