---
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

## Changes

- **2025-12-21** `04ddd9941f01` — 15 info
  - added the optional property `customerAttributes/city` to the response with the `200` status
  - added the optional property `customerAttributes/country` to the response with the `200` status
  - added the optional property `customerAttributes/custom` to the response with the `200` status
  - added the optional property `customerAttributes/devices` to the response with the `200` status
  - …11 more
- **2025-09-30** `788718651767` — 1 info
  - removed the non-success response with the status `404`
- **2025-09-16** `9982cd425d6b` — 3 warning, 7 info
  - removed the optional property `attributes` from the response with the `200` status
  - removed the optional property `email` from the response with the `200` status
  - removed the optional property `mobile` from the response with the `200` status
  - api operation id `getCustomer` was added
  - …6 more
- **2025-09-08** `74802d3d15e7` — 1 info
  - endpoint added
- **2025-09-02** `919eb7a392aa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/gameballers/apis/gameball-api/changes/api/v4.0/integrations/customers/:customerId/get.md)

---

[API](https://skmtc.dev/gameballers/apis/gameball-api.md) · [All operations](https://skmtc.dev/gameballers/apis/gameball-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gameballers/gameball-api/revisions/747ba4697269/schema)