# Notifications

In-app notification inbox for users and installed apps

## List in-app notifications for the logged-in user

 - [GET /api/v2/notifications](https://developer.caraer.com/apis/notifications/listnotifications.md): Returns notifications for the selected company plus user-general notifications that have no company. Other companies are never included.

## Send a notification (app token)

 - [POST /api/v2/notifications](https://developer.caraer.com/apis/notifications/sendnotification.md): Installed apps call this endpoint after async work completes. Authenticate with the installation token (Authorization: Bearer or X-CARAER-TOKEN). Every notification is scoped to the app's company. Omit targetUserUuid to notify every user in that company, or set it to aim the notification at one member.

## Mark a notification as read

 - [PATCH /api/v2/notifications/{notificationId}/read](https://developer.caraer.com/apis/notifications/markasread.md)

## Mark all notifications as read

 - [PATCH /api/v2/notifications/read-all](https://developer.caraer.com/apis/notifications/markallasread.md)

## Mint a Firebase custom token so the app can listen to its inbox

 - [GET /api/v2/notifications/firebase-token](https://developer.caraer.com/apis/notifications/firebasetoken.md)

## Dismiss a notification

 - [DELETE /api/v2/notifications/{notificationId}](https://developer.caraer.com/apis/notifications/dismissnotification.md)