> ## 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 Notifications Count

> Retrieve the total count of notifications for a specific customer in Gameball, providing the number of notifications matching the specified criteria.

This API retrieves the total count of notifications for a specific customer in Gameball, identified by customerId. It provides the number of notifications matching the specified criteria without returning detailed notification records.

<Info>
  **Security**: Requires **apikey** header.
</Info>


## OpenAPI

````yaml GET /api/v4.0/integrations/customers/{customerId}/notifications/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}/notifications/count:
    get:
      summary: Get Customer Notifications Count
      description: >-
        Retrieve the total count of notifications for a specific customer in
        Gameball, providing the number of notifications matching the specified
        criteria.
      operationId: getCustomerNotificationsCount
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
          description: Unique identifier for the customer
        - name: isRead
          in: query
          required: false
          schema:
            type: boolean
          description: Filter notifications based on their read status
        - name: lang
          in: query
          required: false
          schema:
            type: string
          description: Language in which notifications will be retrieved
      responses:
        '200':
          description: Notifications count found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerNotificationsCountResponse'
      security:
        - apiKey: []
components:
  schemas:
    CustomerNotificationsCountResponse:
      type: object
      properties:
        count:
          type: number
          description: >-
            The total number of notifications available for the customer in
            Gameball system
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKey:
      type: apiKey
      in: header
      name: apikey

````