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

# Get Customer Referrals Count

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

## Request

- Base URL: `https://api.gameball.co`
- URL: `https://api.gameball.co/api/v4.0/integrations/customers/{customerId}/referrals/count`
- Auth: API key in header `apikey` and API key in header `secretkey`

This API retrieves the total count of customers referred by a specified customer in Gameball, providing the number of completed and pending referrals.

## Path parameters

- `customerId` string, required

## Response `200`

Customer referrals count retrieved successfully

- CustomerReferralsCountResponse
  - `count` number: The total number of friends referred by the customer available in Gameball system.
  - `totalPending` number: The total number of referred friends who have joined but not yet completed the referral criteria in the Gameball system.
  - `totalActive` number: The total number of referred friends who have successfully completed the referral criteria in the Gameball system.

## Changes

- **2025-12-17** `d43ca6bdac5a`: 3 info
  - the endpoint scheme security `apiKey AND secretKey` was added to the API
  - the endpoint scheme security `apiKey` was removed from the API
  - the endpoint scheme security `secretKey` was removed from the API
- **2025-09-30** `788718651767`: 1 info
  - removed the non-success response with the status `404`
- **2025-09-16** `9982cd425d6b`: 1 info
  - endpoint added
- **2025-09-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/gameballers/apis/gameball-api/changes/api/v4.0/integrations/customers/:customerId/referrals/count/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.dev/gameballers/apis/gameball-api/revisions/57b08ba96257?raw)