---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.com/dev/developer-help/doc/en/api/get-account.md
  - https://yandex.com/dev/developer-help/doc/ru/api/get-account.md
  - https://yandex.com/dev/developer-help/doc/tr/api/get-account.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/developer-help/doc/ru/llms.txt

# Состояние баланса пользователя

Запрос позволяет получить информацию о балансе пользователя. Тело ответа содержит код валюты и количество денег на счете.

## Формат запроса {#request-format}

Чтобы получить информацию о лицевом счете, используйте HTTP-запрос с методом `GET`:

```text
GET /projects/[<project_id>](*popap)/services/[<service_id>](*popap_3)/personal_account
[Host](*popap_1): api-developer.tech.yandex.net
[X-Auth-Key](*popap_2): <ваш API-ключ>
```

{% cut "Ресурс" %}

**<project_id>**

Идентификатор проекта.

**<service_id>**

Идентификатор сервиса.

{% endcut %}

{% cut "Заголовки запроса" %}

**Host**

Адрес узла, предоставляющего API.

**X-Auth-Key**

Ключ авторизации.

{% endcut %}

## Формат ответа {#response-format}

{% list tabs %}

- Запрос выполнен успешно

  В случае успешного выполнения запроса API возвращает ответ с кодом 200. Тело ответа содержит объект в формате JSON:

  ```json
  {
      "personal_account": {
          "currency": "RUB",
          "sum": "0"
      }
  }

  ```

  #### Свойства ответа
  
  #|
  || **Ключ** | **Значение** ||
  || `personal_account` | Объект с информацией о балансе. ||
  || Свойства массива `personal_account` ||
  || `currency` | Код валюты, в которой хранятся деньги на счете. ||
  || `sum` | Количество денег на счете. ||
  |#

- Запрос выполнен с ошибкой

  Если запрос не был успешно обработан, ответное сообщение содержит информацию о возникших ошибках:

  #|
  || **HTTP-код ошибки** | **Описание ошибки** ||
  || `400 Bad Request` | Один из параметров запроса имеет недопустимое значение или формат данных. ||
  || `403 Forbidden` | У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен. ||
  || `404 Not Found` | Запрашиваемый ресурс не найден. ||
  || `500 Internal Server Error` | Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время. ||
  || `503 Service Unavailable` | Сервис API временно недоступен. ||
  |#

{% endlist %}

[*popap]:
 
Идентификатор проекта.

[*popap_1]:
 
Адрес узла, предоставляющего API.

[*popap_2]:
 
Ключ авторизации.

[*popap_3]:
 
Идентификатор сервиса.