---
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/en/llms.txt

# User balance status

The request lets you get information about a user's balance. The response body contains the currency code and the amount of money in their account.

## Request format {#request-format}

To get information about an account, use an HTTP request with the `GET` method:

```text
GET /projects/[<project_id>](*popap_2)/services/[<service_id>](*popap_3)/personal_account
[Host](*popap): api-developer.tech.yandex.net
[X-Auth-Key](*popap_1): <your API key>
```

{% cut "Resource" %}

**<project_id>**

Project ID.

**<service_id>**

Service ID.

{% endcut %}

{% cut "Request headers" %}

**Host**

The URL of the node providing the API.

**X-Auth-Key**

Authorization key.

{% endcut %}

## Response format {#response-format}

{% list tabs %}

- The request has been completed successfully

  If the request has been completed successfully, the API returns a response with the code 200. The response body contains an object in JSON format:
  
  ```json
  {
      "personal_account": {
          "currency": "RUB",
          "sum": "0"
      }
  }
  
  ```
  
  #### Response properties

  #|
  || **Key** | **Value** ||
  || `personal_account` | An object with information about the balance. ||
  || The properties of the `personal_account` object ||
  || `currency` | The code of the currency of the account balance. ||
  || `sum` | The amount of money in the account. ||
  |#

- The request has been executed with an error

  If the request has failed, the response message contains information about errors:

  #|
  || **HTTP error code** | **Error description** ||
  || `400 Bad Request` | One of the request parameters has an invalid value or data format. ||
  || `403 Forbidden` | The user or app does not have rights to access the resource; the request is rejected. ||
  || `404 Not Found` | The requested resource is not found. ||
  || `500 Internal Server Error` | Internal service error. Try resending your request later. ||
  || `503 Service Unavailable` | The API service is temporarily unavailable. ||
  |#

{% endlist %}

[*popap]:
 
The URL of the node providing the API.

[*popap_1]:
 
Authorization key.

[*popap_2]:
 
Project ID.

[*popap_3]:
 
Service ID.