Skip to main content

Notifications

Intotes sends notifications to keep you informed about your trading activity and event outcomes. All notification endpoints require authentication.

Notification Types​

TypeDescription
bet_placedConfirms that your order was successfully placed on a market.
bet_wonYour position resolved in your favor and winnings have been credited.
bet_lostYour position resolved against you.
event_closedAn event you participated in or watched has been closed and settled.

Fetching Notifications​

All Notifications​

GET /api/v1/notifications

Returns your complete notification history, both read and unread.

Unread Notifications Only​

GET /api/v1/notifications/unread

Returns only notifications you have not yet marked as read.

Unread Count​

GET /api/v1/notifications/unread/count

Returns a single integer count of unread notifications. Useful for displaying a badge in the UI without fetching full notification data.

Managing Notifications​

Mark All as Read​

PUT /api/v1/notifications/read-all

Marks every unread notification as read in a single operation.

Mark One as Read​

PUT /api/v1/notifications/{id}/read

Marks a specific notification as read.

Path parameters:

ParameterDescription
idThe UUID of the notification to mark as read.

Delete a Notification​

DELETE /api/v1/notifications/{id}

Permanently removes a notification from your history.

Path parameters:

ParameterDescription
idThe UUID of the notification to delete.

Summary of Endpoints​

MethodEndpointAuthDescription
GET/api/v1/notificationsRequiredList all notifications
GET/api/v1/notifications/unreadRequiredList unread notifications
GET/api/v1/notifications/unread/countRequiredGet unread count
PUT/api/v1/notifications/read-allRequiredMark all as read
PUT/api/v1/notifications/{id}/readRequiredMark one as read
DELETE/api/v1/notifications/{id}RequiredDelete a notification