Skip to main content

/api/v1/accounts REST API Endpoint

List account entities on network

Updated on
Aug 23, 2024

/api/v1/accounts REST API Endpoint

Please note that this method is currently available only on the testnet and will be accessible on the mainnet soon.

Query Parameters

account.balance
string
The optional balance value to compare against
account.id
string
The ID of the account to return information for
account.publickey
string
The account alias or account id or evm address
balance
boolean
Whether to include balance information or not. If included, token balances are limited to at most 50 per account as outlined in HIP-367
limit
integer
The maximum number of items to return
order
string
The order in which items are listed (asc or desc)

Returns

accounts
array
An array of account objects, each representing a single Hedera account with detailed information
account
string
The unique identifier of the account
alias
string
A human-readable alias for the account
auto_renew_period
integer
The period (in seconds) after which the account will automatically renew
balance
object
An object containing the balance details of the account
balance
integer
The current balance of the account in tinybars
timestamp
string
The timestamp when the balance was last updated
tokens
array
An array of token balances associated with the account
created_timestamp
string
The timestamp when the account was created
decline_reward
boolean
A boolean indicating whether the account declines to receive rewards
deleted
boolean
A boolean indicating whether the account has been deleted
ethereum_nonce
integer
The Ethereum nonce associated with the account
evm_address
string
The Ethereum-compatible address of the account
expiry_timestamp
string
The timestamp when the account is set to expire
key
object
An object containing the cryptographic key associated with the account
_type
string
The type of key
key
string
The public key in hexadecimal format
max_automatic_token_associations
integer
The maximum number of token associations the account can automatically handle
memo
string
An optional memo field for the account
pending_reward
integer
The amount of pending rewards for the account
receiver_sig_required
boolean
A boolean indicating if receiver's signature is required for transfers
staked_account_id
string
The account ID to which this account is staked
staked_node_id
string
The node ID to which this account is staked
stake_period_start
string
The start of the staking period
links
object
An object containing pagination links
next
string
The URL for the next set of results if available
Request
1
curl 'https://docs-demo.hedera-mainnet.quiknode.pro/api/v1/accounts'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free