---
title: "Get publisher balance history"
type: reference
method: GET
path: /rest-api/network/management/get-publisher-balance-history.do
tag: "Network Finances"
---

# Get publisher balance history

`GET https://YOUR-NETWORK-DOMAIN/rest-api/network/management/get-publisher-balance-history.do`

One publisher's balance month by month, newest first — what its page shows under Payments: startBalance (the previous month's to be paid), accrued (what it earned), paid (the payouts) and endBalance (still to be paid). 'current' is the newest month, or null. Requires inventory view and SHOW_PUBLISHERS_BALANCE, or the NETWORK_BILLING_MANAGEMENT (enabled or read-only) and PUBLISHERS_PAYMENTS permissions; the publisher must be visible to the caller.

## Query params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `id` | integer | yes | `10` | Publisher (site) ID |

## Responses

- `200` — {success, data:[{year, month, startBalance, accrued, paid, endBalance}], current, startMonth: yyyy-MM|null — the month the balances start from; earlier months are left out}
- `400` — Bad request — invalid or missing parameters
- `401` — Authentication error
- `403` — Not enough permissions

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/network/management/get-publisher-balance-history.do?id=10' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/network-finances/get-network-management-get-publisher-balance-history