Account-info method
Getting information about the status of the user account.
Required permissions: account-info
Request
There are no input parameters.
Request example
POST /api/account-info HTTP/1.1
Host: yoomoney.ru
Authorization: Bearer 410012345678901.0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ0123
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Response
If successful, returns a JSON document containing the following:
ParameterTypeDescription
accountstringUser’s account number.
balanceamountUser’s account balance.
currencystringUser’s account currency code. Always 643 (ruble of the Russian Federation by the ISO 4217 standard).
account_status
string
The user’s status. Possible values:
  • anonymous — anonymous account;
  • named — named account;
  • identified — identified account.
account_type
string
User’s account type. Possible values:
  • personal — user account in YooMoney;
  • professional — professional business account in YooMoney.
balance_details
object
By default, this section is omitted. This section appears if there are now or ever have been deferred deposits, negative balance, blocked funds.
cards_linked
array
Information about bank cards linked to the account.
If the account does not have any cards linked to it, the parameter is omitted. If the account has at least one card linked to it, the parameter contains a list of information about the linked cards.
Parameters of the balance_details object
ParameterTypeDescription
totalamountTotal account balance.
availableamountAmount available for payments.
deposition_pendingamountThe amount of pending deposits. If there are no pending deposits, the parameter is omitted.
blockedamountThe amount of funds blocked by authorities. If there are no blocked funds, the parameter is omitted.
debtamountThe amount owed (the negative balance on the account). If the balance is positive, this parameter is omitted.
holdamountAmount of frozen funds. If there are no frozen funds, the parameter is omitted.
Parameters for the cards_linked object
ParameterTypeDescription
pan_fragmentstringMasked card number.
type
string
Card type. May be omitted if unknown. Possible values:
  • VISA;
  • MasterCard;
  • AmericanExpress;
  • JCB.
Response example
JSON
{
  "account": "4100123456789",
  "balance": 1000.00,
  "currency": "643",
  "account_status": "anonymous",
  "account_type": "personal",
  "cards_linked": [
    {
      "pan_fragment": "510000******9999",
      "type": "MasterCard"
    }
  ]
}