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

# Get Customer Activities Count

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

This API retrieves the total count of customer activities within Gameball, identified by customerId. It allows for filtering by specific activity types, such as TierUpgraded, CampaignRewarded, ReferralBonusReward, and PaymentReward, providing the number of activities matching the specified criteria without returning detailed activity logs.

## Path parameters

- `customerId` string, required

## Query parameters

- `activityType` 'TierUpgraded' | 'TierDowngraded' | 'TierMigration' | 'CampaignRewarded' | 'SuccessfulAction' | 'Referral' | 'Referred' | 'ReferralBonusReward' | 'PaymentReward' | 'Refund' | 'Redemption' | 'Cancel' | 'Expiry' | 'Migration' | 'Lifetime' | 'Automation'

## Response `200`

Customer activities count retrieved successfully

- CustomerActivitiesCountResponse
  - `count` number — The total number of activities available in 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

[Change history](https://skmtc.dev/gameballers/apis/gameball-api/changes/api/v4.0/integrations/customers/:customerId/activities/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/d38ce863fa38?raw)