Skip to main content
GET
/
public
/
v1
/
offsite-ads
/
vendors
/
balances
Get Vendor Balances
curl --request GET \
  --url https://api.topsort.com/public/v1/offsite-ads/vendors/balances \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "vendorId": "<string>",
      "balance": 123
    }
  ]
}

Authorizations

​
Authorization
string
header
required

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Query Parameters

​
vendor_ids
string[]
required

The IDs of the vendors to get the balances for. Maximum of 25 vendors can be queried at once.

Required array length: 1 - 25 elements
Example:
["vendor_123", "vendor_456"]
​
dsp
string
required

The DSP to get the balances for. Only Google Ads is supported currently.

Allowed value: "google_ads"
Example:

"google_ads"

Response

Successful Response

​
items
VendorBalance · object[]
required

The list of vendor balances.