---
title: "Get Customer Notifications"
method: GET
path: "/api/v4.0/integrations/customers/{customerId}/notifications"
---

# Get Customer Notifications

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

Retrieve a paged list of notifications for a specific customer in Gameball, including details such as title, message content, read status, and timestamp.

## Path parameters

- `customerId` string, required

## Query parameters

- `startAfter` integer
- `limit` integer
- `isRead` boolean
- `lang` string

## Response `200`

Notifications list

- CustomerNotifications
  - `notifications` object[]
    - `id` string
    - `title` string
    - `body` string
    - `isRead` boolean
    - `createdAt` string, date-time
  - `nextCursor` string, nullable

## Changes

- **2025-09-16** `9982cd425d6b` — 2 warning, 5 info
  - for the `query` request parameter `limit`, the max was set to `200.00`
  - deleted the `query` request parameter `cursor`
  - the endpoint scheme security `secretKey` was removed from the API
  - added the new optional `query` request parameter `isRead`
  - …3 more
- **2025-09-08** `74802d3d15e7` — 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/notifications/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-service-production.skmtc.workers.dev/v1/apis/gameballers/gameball-api/revisions/747ba4697269/schema)