---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/live/GetBalance.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBalance.md
  - href: ru/live/GetBalance.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# GetBalance (Live)
Сообщает баланс кампании и сумму, зачисленную за время существования кампании.



## Новое в версии Live 4

Добавлен результирующий параметр SumAvailableForTransfer.


## Входные данные {#input}

Ниже показана структура входных данных в формате JSON.

```javascript
{
   "method": "GetBalance",
   "param": [
      (int)
      ...
   ]
}
```

Параметр `param` содержит массив идентификаторов кампаний, для которых нужно получить сведения.


## Результирующие данные {#output}

Ниже показана структура результирующих данных в формате JSON.

```javascript
{
   "data": [
      {  /* CampaignBalanceInfo */
         "CampaignID": (int),
         "Sum": (float),
         "Rest": (float),
         "SumAvailableForTransfer": (float)
      }
      ...
   ]
}
```

Ниже приведено описание параметров.


#|
||
**Параметр**
|
**Описание**
||

||
**Объект CampaignBalanceInfo**
||
||
`CampaignID`
|
Идентификатор кампании.
||
||
`Sum`
|
Если у клиента подключен общий счет — сумма израсходованных средств за все время существования кампании.

Если общий счет не подключен — сумма средств, зачисленных на баланс кампании за время ее существования.

Значение выражено в у. е.

Если кампания ведется в реальной валюте, возвращаемое значение конвертируется из валюты кампании в у. е. и округляется по математическим правилам с точностью до второго знака после запятой.
||
||
`Rest`
|
Текущий баланс общего счета + сумма возврата на кампанию (если у рекламодателя подключен общий счет) или текущий баланс кампании (если общий счет не подключен).


{% note info %}

Сумма возврата средств за клики, признанные системой недобросовестными или ошибочными, может быть израсходована только в рамках этой же кампании.

{% endnote %}


Значение выражено в у. е.

<!-- source: ru/_includes/live/GetCampaignsList/id-output/sum-fixed.md -->
Если кампания ведется в реальной валюте, возвращаемое значение конвертируется из валюты кампании в у. е. и округляется по математическим правилам с точностью до второго знака после запятой.
<!-- endsource: ru/_includes/live/GetCampaignsList/id-output/sum-fixed.md -->
||
||
`SumAvailableForTransfer`
|
Сумма, доступная для перевода с помощью метода [TransferMoney](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/TransferMoney.md). Возвращается только в случае, если общий счет не подключен. Может быть меньше баланса кампании.

Значение выражено в у. е.

<!-- source: ru/_includes/live/GetCampaignsList/id-output/sum-fixed.md -->
Если кампания ведется в реальной валюте, возвращаемое значение конвертируется из валюты кампании в у. е. и округляется по математическим правилам с точностью до второго знака после запятой.
<!-- endsource: ru/_includes/live/GetCampaignsList/id-output/sum-fixed.md -->
||
|#