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

> Retrieve a paged list of notifications for a specific customer in Gameball.

This API retrieves a paged list of notifications for a specific customer in Gameball, identified by `customerId`. Each notification includes details such as title, message content, read status, and timestamp.

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


## OpenAPI

````yaml GET /api/v4.0/integrations/customers/{customerId}/notifications
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:
    get:
      summary: Get Customer Notifications
      description: >-
        Retrieve a paged list of notifications for a specific customer in
        Gameball, including details such as title, message content, read status,
        and timestamp.
      operationId: listCustomerNotifications
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
          description: Unique identifier for the customer
        - name: startAfter
          in: query
          required: false
          schema:
            type: integer
            format: int64
            default: 0
          description: Specifies the page will start after which notification id
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 50
            maximum: 200
          description: Number of notifications to return per page
        - 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 list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerNotifications'
      security:
        - apiKey: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: >-
            curl -X GET
            'https://api.gameball.co/api/v4.0/integrations/customers/12345/notifications'
            -H 'apikey: YOUR_API_KEY' -H 'secretkey: YOUR_SECRET_KEY'
        - lang: javascript
          label: JavaScript
          source: >-
            const res = await
            fetch('https://api.gameball.co/api/v4.0/integrations/customers/12345/notifications',{
            headers:{ apikey:'YOUR_API_KEY', secretkey:'YOUR_SECRET_KEY'}});
            const data = await res.json();
        - lang: python
          label: Python
          source: >-
            import requests

            resp =
            requests.get('https://api.gameball.co/api/v4.0/integrations/customers/12345/notifications',
            headers={'apikey':'YOUR_API_KEY','secretkey':'YOUR_SECRET_KEY'})

            print(resp.json())
        - lang: csharp
          label: C#
          source: >-
            using System.Net.Http;

            var client = new HttpClient();

            client.DefaultRequestHeaders.Add("apikey", "YOUR_API_KEY");

            client.DefaultRequestHeaders.Add("secretkey", "YOUR_SECRET_KEY");

            var res = await
            client.GetAsync("https://api.gameball.co/api/v4.0/integrations/customers/12345/notifications");

            res.EnsureSuccessStatusCode();
        - lang: php
          label: PHP
          source: >-
            <?php\n$ch =
            curl_init('https://api.gameball.co/api/v4.0/integrations/customers/12345/notifications');\ncurl_setopt_array($ch,
            [CURLOPT_HTTPHEADER => ['apikey: YOUR_API_KEY','secretkey:
            YOUR_SECRET_KEY'], CURLOPT_RETURNTRANSFER => true]);\n$resp =
            curl_exec($ch);\n?>
components:
  schemas:
    CustomerNotifications:
      type: object
      properties:
        notifications:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              title:
                type: string
              body:
                type: string
              isRead:
                type: boolean
              createdAt:
                type: string
                format: date-time
        nextCursor:
          type:
            - string
            - 'null'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKey:
      type: apiKey
      in: header
      name: apikey

````