Notifications
Overview
In-app notifications for transaction events, plus push notification support — FCM for Android, APNs for iOS.
List notifications
GET
/notifications
Requires Auth
bash
curl https://app.slimpay.ng/api/v1/notifications \
-H "Authorization: Bearer {token}"
GET
/notifications
No bearer token set. to send authenticated requests.
| Method | Path | Purpose |
|---|---|---|
| GET | /notifications/unread-count | Badge count for a bell icon |
| POST | /notifications/{id}/read | Mark a single notification read |
| POST | /notifications/read-all | Mark everything read |
| DELETE | /notifications/{id} | Delete a notification |
GET
/notifications/unread-count
No bearer token set. to send authenticated requests.
POST
/notifications/{id}/read
No bearer token set. to send authenticated requests.
POST
/notifications/read-all
No bearer token set. to send authenticated requests.
DELETE
/notifications/{id}
Permanently deletes this notification.
No bearer token set. to send authenticated requests.
Push notification device tokens
Register a device token after login so the account can receive push notifications for transaction events (funding received, withdrawal completed, etc.):
POST
/auth/device-token
Requires Auth
bash
curl https://app.slimpay.ng/api/v1/auth/device-token \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{ "token": "fcm-or-apns-device-token", "platform": "android" }'
POST
/auth/device-token
No bearer token set. to send authenticated requests.
Call DELETE /auth/device-token on logout so a shared or reset device stops receiving another user's notifications.
DELETE
/auth/device-token
No bearer token set. to send authenticated requests.
docs