account_info

The account_info command retrieves information about an account, its activity, and its XRP balance. All information retrieved is relative to a particular version of the ledger.

Request Format

An example of an account_info request:

curl --location 'https://xrp.nownodes.io' \
--header 'Content-Type: application/json' \
--header 'api-key: API_KEY' \
--data '{
    "method": "account_info",
    "params": [
        {
            "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
            "ledger_index": "current",
            "queue": true
        }
    ]
}'

The request contains the following parameters:

Field	Type	Required?	Description
account	String - [Address][]	Yes	The account to look up.

The following fields are deprecated and should not be provided: ident, ledger, strict.

Response Format

An example of a successful response:

{
    "id": 5,
    "status": "success",
    "type": "response",
    "result": {
        "account_data": {
            "Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
            "Balance": "999999999960",
            "Flags": 8388608,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 0,
            "PreviousTxnID": "4294BEBE5B569A18C0A2702387C9B1E7146DC3A5850C1E87204951C6FDAA4C42",
            "PreviousTxnLgrSeq": 3,
            "Sequence": 6,
            "index": "92FA6A9FC8EA6018D5D16532D7795C91BFB0831355BDFDA177E86C8BF997985F"
        },
        "ledger_current_index": 4,
        "queue_data": {
            "auth_change_queued": true,
            "highest_sequence": 10,
            "lowest_sequence": 6,
            "max_spend_drops_total": "500",
            "transactions": [
                {
                    "auth_change": false,
                    "fee": "100",
                    "fee_level": "2560",
                    "max_spend_drops": "100",
                    "seq": 6
                },
                ... (trimmed for length) ...
                {
                    "LastLedgerSequence": 10,
                    "auth_change": true,
                    "fee": "100",
                    "fee_level": "2560",
                    "max_spend_drops": "100",
                    "seq": 10
                }
            ],
            "txn_count": 5
        },
        "validated": false
    }
}

{
    "result": {
        "account_data": {
            "Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
            "Balance": "999999999960",
            "Flags": 8388608,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 0,
            "PreviousTxnID": "4294BEBE5B569A18C0A2702387C9B1E7146DC3A5850C1E87204951C6FDAA4C42",
            "PreviousTxnLgrSeq": 3,
            "Sequence": 6,
            "index": "92FA6A9FC8EA6018D5D16532D7795C91BFB0831355BDFDA177E86C8BF997985F"
        },
        "ledger_current_index": 4,
        "queue_data": {
            "auth_change_queued": true,
            "highest_sequence": 10,
            "lowest_sequence": 6,
            "max_spend_drops_total": "500",
            "transactions": [
                {
                    "auth_change": false,
                    "fee": "100",
                    "fee_level": "2560",
                    "max_spend_drops": "100",
                    "seq": 6
                },
                ... (trimmed for length) ...
                {
                    "LastLedgerSequence": 10,
                    "auth_change": true,
                    "fee": "100",
                    "fee_level": "2560",
                    "max_spend_drops": "100",
                    "seq": 10
                }
            ],
            "txn_count": 5
        },
        "status": "success",
        "validated": false
    }
}

{
   "result" : {
      "account_data" : {
         "Account" : "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
         "Balance" : "9986",
         "Flags" : 1114112,
         "LedgerEntryType" : "AccountRoot",
         "OwnerCount" : 0,
         "PreviousTxnID" : "0705FE3F52057924C288296EF0EBF668E0C1A3646FBA8FAF9B73DCC0A797B4B2",
         "PreviousTxnLgrSeq" : 51948740,
         "RegularKey" : "rhLkGGNZdjSpnHJw4XAFw1Jy7PD8TqxoET",
         "Sequence" : 192220,
         "index" : "92FA6A9FC8EA6018D5D16532D7795C91BFB0831355BDFDA177E86C8BF997985F"
      },
      "ledger_hash" : "8169428EDF7F046F817CE44F5F1DF23AD9FAEFFA2CBA7645C3254D66AA79B46E",
      "ledger_index" : 56843712,
      "status" : "success",
      "validated" : true
   }
}

The response follows the [standard format][], with the result containing the requested account, its data, and a ledger to which it applies, as the following fields:

Field	Type	Description
account_data	Object	The AccountRoot ledger object with this account's information, as stored in the ledger.
account_flags	Object	The account's flag statuses (see below), based on the Flags field of the account.

The account_flags field contains the following nested fields:

Field	Type	Description
defaultRipple	Boolean	If true, the account allows rippling on its trust lines by default.
depositAuth	Boolean	If true, the account is using Deposit Authorization and does not accept any payments from unknown parties.
disableMasterKey	Boolean	If true, the account's master key pair is disabled.
disallowIncomingCheck	Boolean	If true, the account does not allow others to send Checks to it. (Requires the [DisallowIncoming amendment][])
disallowIncomingNFTokenOffer	Boolean	If true, the account does not allow others to make NFT buy or sell offers to it. (Requires the [DisallowIncoming amendment][])
disallowIncomingPayChan	Boolean	If true, the account does not allow others to make Payment Channels to it. (Requires the [DisallowIncoming amendment][])
disallowIncomingTrustline	Boolean	If true, the account does not allow others to make trust lines to it. (Requires the [DisallowIncoming amendment][])
disallowIncomingXRP	Boolean	If true, the account does not want to receive XRP from others. (This is advisory, and not enforced at a protocol level.)
globalFreeze	Boolean	If true, all tokens issued by the account are currently frozen.
noFreeze	Boolean	If true, the account has permanently given up the abilities to freeze individual trust lines or end a global freeze. See No Freeze for details.
passwordSpent	Boolean	If false, the account can send a special key reset transaction with a transaction cost of 0. The protocol turns this flag on and off automatically; it is not controlled by a user-facing setting.
requireAuthorization	Boolean	If true, the account is using Authorized Trust Lines to limit who can hold the tokens it issues.
requireDestinationTag	Boolean	If true, the account requires a destination tag on all payments it receives.

The queue_data field, if present, contains the following nested fields:

Field	Type	Description
txn_count	Integer	Number of queued transactions from this address.
auth_change_queued	Boolean	(May be omitted) Whether a transaction in the queue changes this address's ways of authorizing transactions. If true, this address can queue no further transactions until that transaction has been executed or dropped from the queue.
lowest_sequence	Integer	(May be omitted) The lowest [Sequence Number][] among transactions queued by this address.
highest_sequence	Integer	(May be omitted) The highest [Sequence Number][] among transactions queued by this address.
max_spend_drops_total	String	(May be omitted) Integer amount of [drops of XRP][] that could be debited from this address if every transaction in the queue consumes the maximum amount of XRP possible.
transactions	Array	(May be omitted) Information about each queued transaction from this address.

Each object in the transactions array of queue_data, if present, may contain any or all of the following fields:

Field	Type	Description
auth_change	Boolean	Whether this transaction changes this address's ways of authorizing transactions.
fee	String	The Transaction Cost of this transaction, in [drops of XRP][].
fee_level	String	The transaction cost of this transaction, relative to the minimum cost for this type of transaction, in fee levels.
max_spend_drops	String	The maximum amount of [XRP, in drops][], this transaction could send or destroy.
seq	Integer	The [Sequence Number][] of this transaction.

Possible Errors

• Any of the [universal error types][].

• invalidParams - One or more fields are specified incorrectly, or one or more required fields are missing. For example, the request specified queue as true but specified a ledger_index that is not the current open ledger.

• actNotFound - The address specified in the account field of the request does not correspond to an account in the ledger.

• lgrNotFound - The ledger specified by the ledger_hash or ledger_index does not exist, or it does exist but the server does not have it.