Skip to main content

Get Bulk Advertiser Balances

GET 
/marketplaces/:marketplaceID/advertisers/balances

Returns the balances of all active advertisers in a marketplace, with pagination support.

This endpoint provides a bulk view of advertiser balances, eliminating the need to call the single-advertiser balance endpoint for each advertiser individually.

Key characteristics:

  • Returns only active advertisers.
  • balance is the advertiser's current balance.
  • coupons is the total value of active coupons applied to the advertiser's account.
  • Results are ordered by advertiser_id (ascending) for deterministic pagination.
  • Default pagination: page=1, size=100. Maximum size is 500.
  • Invalid pagination values (zero, negative, or exceeding max) fall back to defaults.

Request​

Responses​

Bulk Advertiser Balances Response