Skip to main content
GET
/
api
/
v1
/
accounts
/
{idOrAliasOrEvmAddress}
Get account by alias, id, or evm address
curl --request GET \
  --url https://mainnet.mirrornode.hedera.com/api/v1/accounts/{idOrAliasOrEvmAddress}
{
  "account": "0.0.8",
  "alias": "HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA",
  "auto_renew_period": null,
  "balance": {
    "timestamp": "0.000002345",
    "balance": 80,
    "tokens": [
      {
        "token_id": "0.0.200001",
        "balance": 8
      }
    ]
  },
  "created_timestamp": "1562591528.000123456",
  "decline_reward": false,
  "deleted": false,
  "ethereum_nonce": 10,
  "evm_address": "0xac384c53f03855fa1b3616052f8ba32c6c2a2fec",
  "expiry_timestamp": null,
  "key": null,
  "max_automatic_token_associations": 200,
  "memo": "entity memo",
  "pending_reward": 100,
  "receiver_sig_required": false,
  "staked_account_id": null,
  "staked_node_id": 3,
  "stake_period_start": "172800000.000000000"
}

Path Parameters

​
idOrAliasOrEvmAddress
string
required

Account alias or account id or evm address

Query Parameters

​
limit
integer<int32>
default:25

The maximum number of items to return

Required range: 1 <= x <= 100
​
order
enum<string>
default:desc

The order in which items are listed

Available options:
asc,
desc
​
timestamp
string[]

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

​
transactiontype
enum<string>
Available options:
ATOMICBATCH,
CONSENSUSCREATETOPIC,
CONSENSUSDELETETOPIC,
CONSENSUSSUBMITMESSAGE,
CONSENSUSUPDATETOPIC,
CONTRACTCALL,
CONTRACTCREATEINSTANCE,
CONTRACTDELETEINSTANCE,
CONTRACTUPDATEINSTANCE,
CRYPTOADDLIVEHASH,
CRYPTOAPPROVEALLOWANCE,
CRYPTOCREATEACCOUNT,
CRYPTODELETE,
CRYPTODELETEALLOWANCE,
CRYPTODELETELIVEHASH,
CRYPTOTRANSFER,
CRYPTOUPDATEACCOUNT,
ETHEREUMTRANSACTION,
FILEAPPEND,
FILECREATE,
FILEDELETE,
FILEUPDATE,
FREEZE,
NODE,
NODECREATE,
NODEDELETE,
NODESTAKEUPDATE,
NODEUPDATE,
SCHEDULECREATE,
SCHEDULEDELETE,
SCHEDULESIGN,
SYSTEMDELETE,
SYSTEMUNDELETE,
TOKENAIRDROP,
TOKENASSOCIATE,
TOKENBURN,
TOKENCANCELAIRDROP,
TOKENCLAIMAIRDROP,
TOKENCREATION,
TOKENDELETION,
TOKENDISSOCIATE,
TOKENFEESCHEDULEUPDATE,
TOKENFREEZE,
TOKENGRANTKYC,
TOKENMINT,
TOKENPAUSE,
TOKENREJECT,
TOKENREVOKEKYC,
TOKENUNFREEZE,
TOKENUNPAUSE,
TOKENUPDATE,
TOKENUPDATENFTS,
TOKENWIPE,
UNCHECKEDSUBMIT,
UNKNOWN,
UTILPRNG
​
transactions
boolean
default:true

If provided and set to false transactions will not be included in the response

Response

OK

​
account
string | null
required

Network entity ID in the format of shard.realm.num

Example:

"0.0.2"

​
alias
string | null
required

RFC4648 no-padding base32 encoded account alias

Example:

"HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA"

​
auto_renew_period
integer<int64> | null
required
​
balance
object
required
Example:
{
  "timestamp": "0.000002345",
  "balance": 80,
  "tokens": [{ "token_id": "0.0.200001", "balance": 8 }]
}
​
created_timestamp
string | null
required

A Unix timestamp in seconds.nanoseconds format

Example:

"1586567700.453054000"

​
decline_reward
boolean
required

Whether the account declines receiving a staking reward

​
deleted
boolean | null
required
​
ethereum_nonce
integer<int64> | null
required
​
evm_address
file | null
required

A network entity encoded as an EVM address in hex.

Required string length: 40 - 42
Example:

"0x0000000000000000000000000000000000001f41"

​
expiry_timestamp
string | null
required

A Unix timestamp in seconds.nanoseconds format

Example:

"1586567700.453054000"

​
key
object
required

The public key which controls access to various network entities.

​
max_automatic_token_associations
integer<int32> | null
required
​
memo
string | null
required
​
receiver_sig_required
boolean | null
required
​
staked_account_id
string | null
required

The account to which this account is staking

Example:

"0.0.2"

​
staked_node_id
integer<int64> | null
required

The id of the node to which this account is staking

​
stake_period_start
string | null
required

The staking period during which either the staking settings for this account changed (such as starting staking or changing stakedNode) or the most recent reward was earned, whichever is later. If this account is not currently staked to a node, then the value is null

Example:

"1586567700.453054000"

​
transactions
object[]
required
​
links
object
required
​
pending_reward
integer<int64>

The pending reward in tinybars the account will receive in the next reward payout. Note the value is updated at the end of each staking period and there may be delay to reflect the changes in the past staking period.