GET /v3/bidder/notifications?limit=0 — count-only (badge)
GET
/v3/bidder/notifications
const url = 'https://api-ha-prod-p8.handbid.dev/v3/bidder/notifications?limit=0&auctionId=123';const options = {method: 'GET', headers: {'X-Iphone': '1', Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api-ha-prod-p8.handbid.dev/v3/bidder/notifications?limit=0&auctionId=123' \ --header 'Authorization: Bearer <token>' \ --header 'X-Iphone: 1'Count-only mode for the iOS home-screen bell badge. Skips the list query entirely — only the two indexed counts run. Returns {notifications: [], totalCount: N, unreadCount: M}. Recommended for app-foreground polling.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Header Parameters
Section titled “Header Parameters ” X-Iphone
integer
Example
1Query Parameters
Section titled “Query Parameters ” limit
integer
Example
0 auctionId
integer
NEW (HAN-2351). Optional view-scope filter for themed single-auction views: only that auction’s notifications are returned, and both totalCount and unreadCount reflect the auction-scoped set. Integer >= 1 (400 validation_error otherwise). An unknown auctionId yields empty results with zero counts, not an error. Rows without an auction (system-level general notifications) are excluded when passed.
Example
123Responses
Section titled “ Responses ”Successful response
Media type application/json