Skip to main content
The DOSS app has two separate notification feeds: in-app DOSS notifications (e.g. payment events) and government alert notifications (e.g. emergency alerts). Both feeds support infinite scroll pagination and display an unread count badge.
All notification endpoints require a valid Bearer token in the Authorization header.

​
Get DOSS notifications

GET /v2/doss_notification Returns a paginated list of in-app notifications for the authenticated user.

​
Query parameters

​
page
integer
default:"1"
The page number to fetch for pagination.

​
Response

​
unread
integer
The total count of unread notifications. Displayed on the first page of results.
​
data
object
curl "https://dossapp.com/api/v2/doss_notification?page=1" \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

​
Mark DOSS notification as read

GET /v2/readdoss_notification/:id Marks a specific in-app notification as read. The client calls this endpoint when the user taps a notification item. After a successful response, the notification list is refreshed.

​
Path parameters

​
id
integer
required
The numeric ID of the notification to mark as read.
curl https://dossapp.com/api/v2/readdoss_notification/42 \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

​
Get alert notifications

GET /v2/doss_alert_notification Returns a paginated list of government alert notifications for the authenticated user.

​
Query parameters

​
page
integer
default:"1"
The page number to fetch for pagination.

​
Response

​
unread
integer
The total count of unread alert notifications.
​
data
object
curl "https://dossapp.com/api/v2/doss_alert_notification?page=1" \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

​
Mark alert notification as read

GET /v2/readdoss_alert_notification/:id Marks a specific government alert notification as read. After a successful response, the alert list is refreshed.

​
Path parameters

​
id
integer
required
The numeric ID of the alert notification to mark as read.
curl https://dossapp.com/api/v2/readdoss_alert_notification/7 \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

Build docs developers (and LLMs) love

Get started for freeTalk to us