---
title: "Get account by alias, id, or evm address"
method: GET
path: "/api/v1/accounts/{idOrAliasOrEvmAddress}"
tags: ["accounts"]
---

# Get account by alias, id, or evm address

`GET /api/v1/accounts/{idOrAliasOrEvmAddress}`

Return the account transactions and balance information given an account alias, an account id, or an evm address. The information will be limited to at most 1000 token balances for the account as outlined in HIP-367.
When the timestamp parameter is supplied, we will return transactions and account state for the relevant timestamp query. Balance information will be accurate to within 15 minutes of the provided timestamp query.
Historical ethereum nonce information is currently not available and may not be the exact value at a provided timestamp.

## Path parameters

- `idOrAliasOrEvmAddress` string, required

## Query parameters

- `limit` integer
- `order` 'asc' | 'desc'
- `timestamp` string[]
- `transactiontype` 'ATOMICBATCH' | 'CONSENSUSCREATETOPIC' | 'CONSENSUSDELETETOPIC' | 'CONSENSUSSUBMITMESSAGE' | 'CONSENSUSUPDATETOPIC' | 'CONTRACTCALL' | 'CONTRACTCREATEINSTANCE' | 'CONTRACTDELETEINSTANCE' | 'CONTRACTUPDATEINSTANCE' | 'CRYPTOADDLIVEHASH' | 'CRYPTOAPPROVEALLOWANCE' | 'CRYPTOCREATEACCOUNT' | 'CRYPTODELETE' | 'CRYPTODELETEALLOWANCE' | 'CRYPTODELETELIVEHASH' | 'CRYPTOTRANSFER' | 'CRYPTOUPDATEACCOUNT' | 'ETHEREUMTRANSACTION' | 'FILEAPPEND' | 'FILECREATE' | 'FILEDELETE' | 'FILEUPDATE' | 'FREEZE' | 'HOOKSTORE' | 'LEDGERIDPUBLICATION' | 'NODECREATE' | 'NODEDELETE' | 'NODESTAKEUPDATE' | 'NODEUPDATE' | 'REGISTEREDNODECREATE' | 'REGISTEREDNODEDELETE' | 'REGISTEREDNODEUPDATE' | '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' | 'UTILPRNG'
- `transactions` boolean

## Response `200`

OK

- AccountBalanceTransactions
  - `account` string, nullable, required — Network entity ID in the format of `shard.realm.num`
  - `alias` string, nullable, required — RFC4648 no-padding base32 encoded account alias
  - `auto_renew_period` integer, nullable, required
  - `balance` Balance, nullable, required
    - `timestamp` string, nullable, required — A Unix timestamp in seconds.nanoseconds format
    - `balance` integer, nullable, required
    - `tokens` object[], required
      - `token_id` string, nullable — Network entity ID in the format of `shard.realm.num`
      - `balance` integer
  - `created_timestamp` string, nullable, required — A Unix timestamp in seconds.nanoseconds format
  - `decline_reward` boolean, required — Whether the account declines receiving a staking reward
  - `deleted` boolean, nullable, required
  - `ethereum_nonce` integer, nullable, required
  - `evm_address` string, binary, nullable, required — A network entity encoded as an EVM address in hex.
  - `expiry_timestamp` string, nullable, required — A Unix timestamp in seconds.nanoseconds format
  - `key` Key, nullable, required — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `max_automatic_token_associations` integer, nullable, required
  - `memo` string, nullable, required
  - `pending_reward` integer — 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.
  - `receiver_sig_required` boolean, nullable, required
  - `staked_account_id` string, nullable, required — The account to which this account is staking
  - `staked_node_id` integer, nullable, required — The id of the node to which this account is staking
  - `stake_period_start` string, nullable, 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
  - `transactions` Transaction[], required
    - `batch_key` Key, nullable — The public key which controls access to various network entities.
      - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
      - `key` string
    - `bytes` string, byte, nullable
    - `charged_tx_fee` integer
    - `consensus_timestamp` string — A Unix timestamp in seconds.nanoseconds format
    - `entity_id` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `high_volume` boolean — Whether the transaction used high-volume entity creation throttles and pricing per HIP-1313
    - `high_volume_pricing_multiplier` integer, nullable — The multiplier applied to the transaction fee when high-volume pricing was in effect per HIP-1313, scaled by 1000 (e.g. 1000 = 1x, 4000 = 4x). A value of 0 means high-volume pricing was not applied. Null for pre-HIP-1313 transactions.
    - `max_custom_fees` CustomFeeLimit[]
      - `account_id` string, nullable — Network entity ID in the format of `shard.realm.num`
      - `amount` integer
      - `denominating_token_id` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `max_fee` string
    - `memo_base64` string, byte, nullable
    - `name` 'ATOMICBATCH' | 'CONSENSUSCREATETOPIC' | 'CONSENSUSDELETETOPIC' | 'CONSENSUSSUBMITMESSAGE' | 'CONSENSUSUPDATETOPIC' | 'CONTRACTCALL' | 'CONTRACTCREATEINSTANCE' | 'CONTRACTDELETEINSTANCE' | 'CONTRACTUPDATEINSTANCE' | 'CRYPTOADDLIVEHASH' | 'CRYPTOAPPROVEALLOWANCE' | 'CRYPTOCREATEACCOUNT' | 'CRYPTODELETE' | 'CRYPTODELETEALLOWANCE' | 'CRYPTODELETELIVEHASH' | 'CRYPTOTRANSFER' | 'CRYPTOUPDATEACCOUNT' | 'ETHEREUMTRANSACTION' | 'FILEAPPEND' | 'FILECREATE' | 'FILEDELETE' | 'FILEUPDATE' | 'FREEZE' | 'HOOKSTORE' | 'LEDGERIDPUBLICATION' | 'NODECREATE' | 'NODEDELETE' | 'NODESTAKEUPDATE' | 'NODEUPDATE' | 'REGISTEREDNODECREATE' | 'REGISTEREDNODEDELETE' | 'REGISTEREDNODEUPDATE' | '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' | 'UTILPRNG'
    - `nft_transfers` object[]
      - `is_approval` boolean, required
      - `receiver_account_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `sender_account_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `serial_number` integer, required
      - `token_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
    - `node` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `nonce` integer
    - `parent_consensus_timestamp` string, nullable — A Unix timestamp in seconds.nanoseconds format
    - `result` string
    - `scheduled` boolean
    - `staking_reward_transfers` StakingRewardTransfer[]
      - `account` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `amount` integer, required — The number of tinybars awarded
    - `token_transfers` object[]
      - `token_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `account` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `amount` integer, required
      - `is_approval` boolean
    - `transaction_hash` string, byte
    - `transaction_id` string
    - `transfers` object[]
      - `account` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `amount` integer, required
      - `is_approval` boolean
    - `valid_duration_seconds` string
    - `valid_start_timestamp` string — A Unix timestamp in seconds.nanoseconds format
  - `links` Links, required
    - `next` string, nullable

## Other responses

- `400` — Invalid parameter
- `404` — Not Found

---

[API](https://skmtc.dev/hedera/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hedera/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hedera/mirror-node-rest-api/revisions/45f5ccac560c/schema)