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';
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' \
  --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

bearer

Parameters

Header Parameters

X-Iphone

integer

Example

Query Parameters

limit

integer

Example

Responses

200

Successful response

application/json