# Получение баланса клиента
## Описание метода

Осуществляется с помощью POST-запроса. Название операции и набор принимаемых полей настраиваются в системе Майндбокс. Подробней про вызов метода можно прочитать [здесь](https://developers.mindbox.ru/docs/v3).

```xml title="Универсальная операция"
POST https://api.mindbox.ru/v3/operations/{синхронная/асинхронная операция}?endpointId={уникальный идентификатор сайта/мобильного приложения/и т.п.}&operation={название операции}&deviceUUID={уникальный идентификатор устройства}


Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey {Секретный ключ, обязательность уточнить у менеджера}

<operation>
  <customer>
    <ids>
      <webSiteUserId>{Идентификатор клиента}</webSiteUserId>
    </ids>
  </customer>
</operation>
```

## Примеры операций

```xml title="Получение баланса клиента"
POST https://api.mindbox.ru/v3/operations/sync?endpointId=MindboxRu&operation=giveCustomerBalance

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey D061p764m85bklq


<operation>
  <customer>
    <ids>
      <webSiteUserId>5384275</webSiteUserId>
    </ids>
  </customer>
</operation>
```

## Ответ

```xml title="Получение баланса клиента"
<result>
  <status>Success</status>
  <balances>
    <balance>
      <totalValue>{Сумма баллов, накопленных за все время программы}</totalValue>
      <availableValue>{Сумма баллов, доступная к трате}</availableValue>
      <blockedValue>{Сумма баллов, недоступная к трате}</blockedValue>
      <balanceType>
        <ids>
          <systemName>{Системное имя балльного счёта}</systemName>
        </ids>
        <name>{Название балльного счёта}</name>
      </balanceType>
    </balance>
  </balances>
</result>
```

:::warning
  Порядок элементов в массиве `balances` не гарантирован и может меняться. Если на проекте более двух балльных счетов, при обработке ответа полагайтесь не на порядок в массиве, а на системное имя балльного счета (`systemName`).
:::