Skip to content

PUT /v3/bidder/notifications/read-all — bulk mark-as-read

PUT
/v3/bidder/notifications/read-all
curl --request PUT \
--url 'https://api-ha-prod-p8.handbid.dev/v3/bidder/notifications/read-all?auctionId=123' \
--header 'Authorization: Bearer <token>' \
--header 'X-Iphone: 1'

Instagram-style bulk mark-as-read [HAN-1881]. Empty body. Returns {count: N} where N is the number of rows transitioned from unread → read. Idempotent — count: 0 when nothing was unread. Writes BOTH status='read' AND priority=0 (V1 setMessagePriority compat). Whitelabel-gated — won’t mark notifications from other-WL auctions. Rate limit: authed=20/min via bidderNotificationsReadAll.

X-Iphone
integer
Example
1
auctionId
integer
>= 1

NEW (HAN-2351). Optional scope: only that auction’s unread notifications transition to read; everything else stays unread. Integer >= 1 (400 validation_error otherwise); unknown auctionId returns {count: 0}.

Example
123

Successful response

Media type application/json