> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Activities Count

> Retrieve the total count of customer activities within Gameball, with optional filtering by activity type.

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.

<Info>
  **Security**: Requires **apikey** and **secretkey** headers.
</Info>


## OpenAPI

````yaml GET /api/v4.0/integrations/customers/{customerId}/activities/count
openapi: 3.1.0
info:
  title: Gameball API
  description: >-
    Gameball REST API v4.0 - Complete API reference for integrating loyalty,
    gamification, and customer engagement features
  version: 4.0.0
servers:
  - url: https://api.gameball.co
security:
  - bearerAuth: []
paths:
  /api/v4.0/integrations/customers/{customerId}/activities/count:
    get:
      summary: Get Customer Activities Count
      description: >-
        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.
      operationId: getCustomerActivitiesCount
      parameters:
        - name: customerId
          in: path
          required: true
          description: >-
            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.
          schema:
            type: string
        - name: activityType
          in: query
          required: false
          schema:
            type: string
            enum:
              - TierUpgraded
              - TierDowngraded
              - TierMigration
              - CampaignRewarded
              - SuccessfulAction
              - Referral
              - Referred
              - ReferralBonusReward
              - PaymentReward
              - Refund
              - Redemption
              - Cancel
              - Expiry
              - Migration
              - Lifetime
              - Automation
          description: >-
            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).
      responses:
        '200':
          description: Customer activities count retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerActivitiesCountResponse'
              example:
                count: 240
      security:
        - apiKey: []
          secretKey: []
components:
  schemas:
    CustomerActivitiesCountResponse:
      type: object
      properties:
        count:
          type: number
          description: The total number of activities available in Gameball system.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKey:
      type: apiKey
      in: header
      name: apikey
    secretKey:
      type: apiKey
      in: header
      name: secretkey

````