Notifications

List notifications

GET/api/v1/notifications

Lists the signed-in user's notifications, most recent first.

Requires Authorization

Session

Query parameters

`page`number	Defaults to 1.
`limit`number	Max 100. Defaults to 20.
`unreadOnly`boolean	Only return unread notifications.

Notes

Notifications are retained for 90 days.

Request

curl --request GET \
  --url https://api.swiftgoma.com/api/v1/notifications \
  --header 'Authorization: Bearer <access_token>'

200Example response

{
  "success": true,
  "data": {
    "notifications": [
      {
        "id": "notif_1a2b3c",
        "userId": "3f2a1c9e",
        "type": "ORDER_STATUS",
        "title": "Votre commande a été acceptée",
        "body": "Boutique Aline vient d'accepter votre commande.",
        "data": {
          "orderId": "ord_5e6f7a"
        },
        "isRead": false,
        "createdAt": "2026-02-15T09:10:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
}