Balances

List balances

One row per partner per currency: pending_minor (earned, inside the hold), due_minor (payable now), paid_minor (sent). Ordered by partner then currency; the cursor is a balance id.

Scope: read

get/v1/balances

Request

  • Base URL: https://api.affiliaterail.com
  • URL: https://api.affiliaterail.com/v1/balances
  • Auth: HTTP bearer

Query parameters

program_idstring required

Required on every list

Example:prg_7uSyy9FqVLCFWrdPeZaK
limitstring

1 to 100, default 25

Example:25
starting_afterstring

Object id; returns the page after it (older)

ending_beforestring

Object id; returns the page before it (newer)

string
OR
string[]
string
OR
string[]
partner_idstring
currencystring

Response

Balances

has_moreboolean required

Pass the last object's id as starting_after to fetch the next page

total_countinteger required

Count of every object matching the filters, ignoring the cursor

Example response

{
  "data": [
    {
      "id": "bal_part_7uSyy9FqVLCFWrdPeZaK_USD",
      "partner_id": "part_7uSyy9FqVLCFWrdPeZaK",
      "currency": "USD",
      "pending_minor": 2500,
      "due_minor": 2500,
      "paid_minor": 2500,
      "updated_at": "2026-08-21T10:15:30.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.