---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.3
alternate:
  - https://yandex.ru/dev/promopages-api/doc/ru/reference/get-balance.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/promopages-api/doc/ru/llms.txt


# Получить баланс кошелька

Получает баланс кошелька.

Запрос на получение отчета следует передавать по протоколу HTTPS методом GET.

Параметры необходимо указывать в параметрах запроса в формате json. Данные передаются в кодировке UTF-8.


## Формат запроса {#input}

```
GET https://promopages.yandex.ru/api/promo/v1/publishers/balances?publisherIds={[publisherIds](*publisherIds)}
```

#|
|| publisherIds
|
ID кабинетов, через запятую. Обязательный параметр.

Получить ID кабинетов можно в этом [методе](https://yandex.ru/dev/promopages-api/doc/ru/reference/get-user.md).
||
|#


## Формат ответа {#output-structure}

```json
{
  "balances": [
    {
      "publisherId": (string),
      "balance": (double)
    }
  ]
}
```

#### Структура balances

| **Параметр** | **Тип** | **Описание** |
| ----- | ----- | ----- |
| `publisherId` | String | Идентификатор кабинета. |
| `balance` | double | Баланс. |

<!--<concept id="example-JSON">
    <title>Пример</title>
    <conbody>
        <example>
            <p>Запрос:</p>
            <codeblock code-lang="http" wrap="yes">https://zen.yandex.ru/api/promo/v1/reports/621e101296d79c3daa2c94fa?format=json</codeblock>
            <p>Ответ:</p>
            <codeblock code-lang="json" wrap="yes">{
"type": "campaigns_previews_daily_stats",
"statistics": [
    {
        "campaignId": "5e67a3c5bf998668491f9079",
        "publicationId": "5d67c6491ee34f00ad33c655",
        "previewId": "5d67c6491ee34f00ad33c655",
        "mskDate": "2022-02-10",
        "impressions": 1791,
        "reach": 1697,
        "budget": 42.0,
        "cpm": 23.45,
        "clickouts": 6,
        "clickoutCost": 7.0,
        "clickoutPercent": 29,
        "fullReads": 21,
        "fullReadPercent": 42,
        "ctr": 0.01172529,
        "metricaVisits": 4,
        "metricaVisitPercent": 10,
        "metricaVisitCost": 10.5
    },
]
}                  </codeblock>
        </example>
    </conbody>
</concept>-->

[*publisherIds]: ID кабинетов, через запятую. Обязательный параметр.
Получить ID кабинетов можно в этом [методе](https://yandex.ru/dev/promopages-api/doc/ru/reference/get-user.md).