Notifications

Base path: /notifications

In-app notifications — currently used for tier-upgrade and promo announcements.

List

GET /notifications — your 20 most recent, newest first.

[
  {
    "id": "...",
    "type": "tier_upgrade",
    "title": "You've reached Growth tier!",
    "message": "You're now paying KES 0.46/SMS — a reward for your loyalty with us. Keep going — Business tier unlocks at 20,000 SMS.",
    "is_read": false,
    "created_at": "2026-07-01T09:00:00Z"
  }
]

Unread count

GET /notifications/unread-count → { "count": 3 }

Mark as read

• PATCH /notifications/{notification_id}/read — one notification.
• PATCH /notifications/read-all — everything.