Skip to main content
GET
/
api
/
v4.0
/
integrations
/
customers
/
{customerId}
/
activities
/
count
Get Customer Activities Count
curl --request GET \
  --url https://api.gameball.co/api/v4.0/integrations/customers/{customerId}/activities/count \
  --header 'apikey: <api-key>' \
  --header 'secretkey: <api-key>'
{
  "count": 240
}
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.
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 that you can reference across the customer's whole lifetime. Could be a database ID, random string, email, or anything that uniquely identifies the customer.

Query Parameters

​
activityType
enum<string>

Filters activities by a specific type, such as: TierUpgraded (Indicates that the customer has been upgraded to a new tier), TierDowngraded (Indicates that the customer has been downgraded to a lower tier), TierMigration (Represents the migration of the customer's tier), CampaignRewarded (Signifies that the customer received a reward from a campaign), SuccessfulAction (Denotes successful progress by the customer in a campaign), Referral (Indicates that the customer referred a friend), Referred (The referee received a reward for being referred by the customer), ReferralBonusReward (Represents a bonus reward given for a referral), PaymentReward (Signifies that the customer received a cashback reward), Refund (Points were refunded back to the customer), Redemption (Points were redeemed by the customer), Cancel (A cashback transaction was canceled), Expiry (Indicates that points have expired), Migration (Represents a migration activity that occurred), Lifetime (Refers to activities related to lifetime coupons), Automation (Activity performed by an automation campaign).

Available options:
TierUpgraded,
TierDowngraded,
TierMigration,
CampaignRewarded,
SuccessfulAction,
Referral,
Referred,
ReferralBonusReward,
PaymentReward,
Refund,
Redemption,
Cancel,
Expiry,
Migration,
Lifetime,
Automation

Response

200 - application/json

Customer activities count retrieved successfully

​
count
number

The total number of activities available in Gameball system.