Skip to main content

account_info RPC Method

Retrieving information about an XRP Ledger account, such as its balance, sequence number, and other account details

Updated on
Jun 11, 2026

Parameters

object
object
REQUIRED

The account_info request object.

account
string
REQUIRED

The XRP Ledger account for which information is to be retrieved

strict
boolean

A boolean value indicating whether strict validation should be applied

ledger_index
string

The ledger index to retrieve the account information from

queue
boolean

A boolean value indicating whether to include information about the account's transaction queue

Returns

result
object

The method returns a JSON object with the following properties:

account_data
object

The details of the account data

Account
string

The XRP Ledger account

Balance
string

The account balance

Flags
integer

Flags associated with the account

LedgerEntryType
string

The type of ledger entry

OwnerCount
integer

The number of accounts that own this account

PreviousTxnID
string

The ID of the previous transaction involving this account

PreviousTxnLgrSeq
integer

The ledger sequence of the previous transaction involving this account

RegularKey
string

The regular key associated with the account

Sequence
integer

The sequence number of the account

index
string

The index of the account

signer_lists
array

(Optional) An array of SignerList ledger objects associated with this account for Multi-Signing. Omitted unless the request specified 'signer_lists' and at least one 'SignerList' is associated with the account

ledger_current_index
integer

(Optional) The index of the current ledger. Omitted if 'ledger_index' is provided instead

ledger_index
integer

(Optional) The ledger index of the ledger version used when retrieving this information. Omitted if 'ledger_current_index' is provided instead

queue_data
object

(Optional) An array that contains information about the account's transaction queue. Omitted unless 'queue' specified as true and querying the current open ledger

txn_count
integer

The number of transactions in the account's queue

auth_change_queued
boolean

Whether a transaction in the queue changes the authorization mechanism for transactions associated with a specific address

lowest_sequence
integer

The lowest sequence number among transactions queued by this address

highest_sequence
integer

The highest sequence number among transactions queued by this address

max_spend_drops_total
string

The maximum amount of XRP, expressed as an integer value in drops, that could be debited from a specific address if every transaction in the queue consumes the maximum amount of XRP possible

transactions
array

The information about each queued transaction from this address

auth_change
boolean

A boolean value indicating whether this transaction changes this address's ways of authorizing transactions

fee
string

The transaction cost, in XRP drops

fee_level
string

The transaction cost relative to minimum cost 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

validated
boolean

Indicates if the information is from a validated ledger

status
string

The status of the request

warnings
array

(Optional) A list of warnings. Returned at the JSON-RPC response root on some servers and omitted from the result object

id
integer

The ID of the warning

message
string

The warning message

Request
Response
1
{
2
"result": {
3
"account_data": {
4
"Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
5
"Balance": "119111334",
6
"Flags": 1048576,
7
"LedgerEntryType": "AccountRoot",
8
"MessageKey": "0200000000000000000000000038901D3A772963CF12FF7C0E010FE350B6CCC45D",
9
"OwnerCount": 0,
10
"PreviousTxnID": "599F8A0E659D42D174B7DEDD962C531DF2A05175AF5AA45946B8E102F20D3436",
11
"PreviousTxnLgrSeq": 101941845,
12
"RegularKey": "rhLkGGNZdjSpnHJw4XAFw1Jy7PD8TqxoET",
13
"Sequence": 192223,
14
"index": "92FA6A9FC8EA6018D5D16532D7795C91BFB0831355BDFDA177E86C8BF997985F"
15
},
16
"account_flags": {
17
"allowTrustLineClawback": false,
18
"allowTrustLineLocking": false,
19
"defaultRipple": false,
20
"depositAuth": false,
21
"disableMasterKey": true,
22
"disallowIncomingCheck": false,
23
"disallowIncomingNFTokenOffer": false,
24
"disallowIncomingPayChan": false,
25
"disallowIncomingTrustline": false,
26
"disallowIncomingXRP": false,
27
"globalFreeze": false,
28
"noFreeze": false,
29
"passwordSpent": false,
30
"requireAuthorization": false,
31
"requireDestinationTag": false
32
},
33
"ledger_current_index": 102609804,
34
"queue_data": {
35
"txn_count": 0
36
},
37
"validated": false,
38
"status": "success"
39
},
40
"status": "success",
41
"type": "response",
42
"forwarded": true,
43
"warnings": [
44
{
45
"id": 2001,
46
"message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
47
}
48
]
49
}
1
{
2
"result": {
3
"account_data": {
4
"Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
5
"Balance": "119111334",
6
"Flags": 1048576,
7
"LedgerEntryType": "AccountRoot",
8
"MessageKey": "0200000000000000000000000038901D3A772963CF12FF7C0E010FE350B6CCC45D",
9
"OwnerCount": 0,
10
"PreviousTxnID": "599F8A0E659D42D174B7DEDD962C531DF2A05175AF5AA45946B8E102F20D3436",
11
"PreviousTxnLgrSeq": 101941845,
12
"RegularKey": "rhLkGGNZdjSpnHJw4XAFw1Jy7PD8TqxoET",
13
"Sequence": 192223,
14
"index": "92FA6A9FC8EA6018D5D16532D7795C91BFB0831355BDFDA177E86C8BF997985F"
15
},
16
"account_flags": {
17
"allowTrustLineClawback": false,
18
"allowTrustLineLocking": false,
19
"defaultRipple": false,
20
"depositAuth": false,
21
"disableMasterKey": true,
22
"disallowIncomingCheck": false,
23
"disallowIncomingNFTokenOffer": false,
24
"disallowIncomingPayChan": false,
25
"disallowIncomingTrustline": false,
26
"disallowIncomingXRP": false,
27
"globalFreeze": false,
28
"noFreeze": false,
29
"passwordSpent": false,
30
"requireAuthorization": false,
31
"requireDestinationTag": false
32
},
33
"ledger_current_index": 102609804,
34
"queue_data": {
35
"txn_count": 0
36
},
37
"validated": false,
38
"status": "success"
39
},
40
"status": "success",
41
"type": "response",
42
"forwarded": true,
43
"warnings": [
44
{
45
"id": 2001,
46
"message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
47
}
48
]
49
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free