> ## Documentation Index > Fetch the complete documentation index at: https://docs.hedera.com/llms.txt > Use this file to discover all available pages before exploring further. # Get account by alias, id, or evm address > 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. ## OpenAPI ````yaml /openapi.yaml get /api/v1/accounts/{idOrAliasOrEvmAddress} openapi: 3.0.3 info: title: Mirror Node REST API version: 0.154.0 license: name: Apache-2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html description: >- The REST API offers the ability to query transactions and entity information from a mirror node. Base url: [/api/v1](/api/v1) OpenAPI Spec: [/api/v1/docs/openapi.yml](/api/v1/docs/openapi.yml) contact: name: Mirror Node Team email: mirrornode@hedera.com url: https://github.com/hiero-ledger/hiero-mirror-node servers: - description: The current REST API server url: '' - description: The production REST API servers url: '{scheme}://{network}.mirrornode.hedera.com' variables: scheme: default: https description: The URI scheme enum: - http - https network: default: testnet description: The Hedera network in use enum: - mainnet-public - mainnet - previewnet - testnet security: [] tags: - name: accounts description: >- The accounts object represents the information associated with an account entity and returns a list of account information.The accounts list endpoint is cached and not updated as frequently as the account lookup by a specific ID endpoint. externalDocs: url: >- https://docs.hedera.com/guides/docs/mirror-node-api/cryptocurrency-api#accounts - name: balances description: >- The balance object represents the balance of accounts on the Hedera network. externalDocs: url: >- https://docs.hedera.com/guides/docs/mirror-node-api/cryptocurrency-api#balances - name: contracts description: >- The contracts objects represents the information associated with contract entities.The contracts list endpoint is cached and not updated as frequently as the contract lookup by a specific ID endpoint. - name: schedules description: >- The schedules object represents the information associated with a schedule entity.The schedules list endpoints is cached and not updated as frequently as the schedule lookup by a specific ID endpoint. - name: transactions description: >- The transaction object represents the transactions processed on the Hedera network. externalDocs: url: >- https://docs.hedera.com/guides/docs/mirror-node-api/cryptocurrency-api#transactions - name: topics description: >- The topics object represents the information associated with a topic entity and returns topic messages information. externalDocs: url: >- https://docs.hedera.com/guides/docs/mirror-node-api/cryptocurrency-api#topic-messages - name: tokens description: >- The tokens object represents the information associated with a token entity and returns a list of token information.The tokens list endpoint is cached and not updated as frequently as the token lookup by a specific ID. externalDocs: description: REST API Docs url: https://docs.hedera.com/guides/docs/mirror-node-api/cryptocurrency-api paths: /api/v1/accounts/{idOrAliasOrEvmAddress}: get: tags: - accounts summary: Get account by alias, id, or evm address description: > 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. operationId: getAccount parameters: - $ref: '#/components/parameters/accountIdOrAliasOrEvmAddressPathParam' - $ref: '#/components/parameters/limitQueryParam' - $ref: '#/components/parameters/orderQueryParamDesc' - $ref: '#/components/parameters/timestampQueryParam' - $ref: '#/components/parameters/transactionTypeQueryParam' - $ref: '#/components/parameters/transactionsQueryParam' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AccountBalanceTransactions' '400': $ref: '#/components/responses/InvalidParameterError' '404': $ref: '#/components/responses/NotFoundError' components: parameters: accountIdOrAliasOrEvmAddressPathParam: name: idOrAliasOrEvmAddress in: path description: Account alias or account id or evm address required: true examples: aliasOnly: value: HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA realmAlias: value: 0.HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA shardRealmAlias: value: 0.1.HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA accountNumOnly: value: 8 realmAccountNum: value: 0.8 shardRealmAccountNum: value: 0.0.8 evmAddress: value: ac384c53f03855fa1b3616052f8ba32c6c2a2fec evmAddressWithPrefix: value: 9.832019034092927e+47 evmAddressWithShardAndRealm: value: 0.0.ac384c53f03855fa1b3616052f8ba32c6c2a2fec schema: pattern: >- ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40}|(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8}))$ type: string limitQueryParam: name: limit in: query description: The maximum number of items to return example: 2 schema: format: int32 type: integer default: 25 minimum: 1 maximum: 100 orderQueryParamDesc: name: order in: query description: The order in which items are listed example: asc schema: enum: - asc - desc default: desc timestampQueryParam: description: >- The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See [unixtimestamp.com](https://www.unixtimestamp.com/) for a simple way to convert a date to the 'seconds' part of the Unix time. name: timestamp in: query explode: true examples: noValue: summary: '--' value: '' secondsNoOperator: summary: Example of seconds equals with no operator value: 1234567890 timestampNoOperator: summary: Example of timestamp equals with no operator value: 1234567890 secondsEqOperator: summary: Example of seconds equals with operator value: eq:1234567890 timestampEqOperator: summary: Example of timestamp equals with operator value: eq:1234567890.000000200 secondsNeOperator: summary: Example of seconds not equals operator value: ne:1234567890 timestampNeOperator: summary: Example of timestamp not equals operator value: ne:1234567890.000000300 secondsGtOperator: summary: Example of seconds greater than operator value: gt:1234567890 timestampGtOperator: summary: Example of timestamp greater than operator value: gt:1234567890.000000400 secondsGteOperator: summary: Example of seconds greater than or equals operator value: gte:1234567890 timestampGteOperator: summary: Example of timestamp greater than or equals operator value: gte:1234567890.000000500 secondsLtOperator: summary: Example of seconds less than operator value: lt:1234567890 timestampLtOperator: summary: Example of timestamp less than operator value: lt:1234567890.000000600 secondsLteOperator: summary: Example of seconds less than or equals operator value: lte:1234567890 timestampLteOperator: summary: Example of timestamp less than or equals operator value: lte:1234567890.000000700 schema: type: array items: type: string pattern: ^((eq|gt|gte|lt|lte|ne):)?\d{1,10}(\.\d{1,9})?$ transactionTypeQueryParam: name: transactiontype in: query example: null schema: $ref: '#/components/schemas/TransactionTypes' transactionsQueryParam: name: transactions description: >- If provided and set to false transactions will not be included in the response in: query example: true schema: type: boolean default: true schemas: AccountBalanceTransactions: allOf: - $ref: '#/components/schemas/AccountInfo' - type: object required: - transactions - links properties: transactions: $ref: '#/components/schemas/Transactions' links: $ref: '#/components/schemas/Links' TransactionTypes: type: string enum: - 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 AccountInfo: type: object required: - account - alias - auto_renew_period - balance - created_timestamp - decline_reward - deleted - ethereum_nonce - evm_address - expiry_timestamp - key - max_automatic_token_associations - memo - receiver_sig_required - staked_account_id - staked_node_id - stake_period_start properties: account: $ref: '#/components/schemas/EntityId' alias: $ref: '#/components/schemas/Alias' auto_renew_period: type: integer format: int64 nullable: true balance: $ref: '#/components/schemas/Balance' created_timestamp: $ref: '#/components/schemas/TimestampNullable' decline_reward: description: Whether the account declines receiving a staking reward type: boolean deleted: type: boolean nullable: true ethereum_nonce: type: integer format: int64 nullable: true evm_address: $ref: '#/components/schemas/EvmAddressNullable' expiry_timestamp: $ref: '#/components/schemas/TimestampNullable' key: $ref: '#/components/schemas/Key' max_automatic_token_associations: type: integer format: int32 nullable: true memo: type: string nullable: true pending_reward: description: > 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. type: integer format: int64 receiver_sig_required: type: boolean nullable: true staked_account_id: allOf: - $ref: '#/components/schemas/EntityId' - description: The account to which this account is staking staked_node_id: description: The id of the node to which this account is staking type: integer format: int64 nullable: true stake_period_start: allOf: - $ref: '#/components/schemas/TimestampNullable' - description: > 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: 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' Transactions: type: array items: $ref: '#/components/schemas/Transaction' Links: type: object properties: next: example: null nullable: true type: string Error: type: object properties: _status: type: object properties: messages: type: array items: type: object properties: data: description: Error message in hexadecimal example: '0x3000' format: binary nullable: true pattern: ^0x[0-9a-fA-F]+$ type: string detail: description: Detailed error message example: Generic detailed error message nullable: true type: string message: description: Error message example: Generic error message nullable: false type: string EntityId: type: string description: Network entity ID in the format of `shard.realm.num` pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$ example: 0.0.2 nullable: true Alias: description: RFC4648 no-padding base32 encoded account alias type: string pattern: ^(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8})$ nullable: true example: HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA Balance: type: object required: - timestamp - balance - tokens properties: timestamp: $ref: '#/components/schemas/TimestampNullable' balance: type: integer format: int64 nullable: true tokens: type: array items: type: object properties: token_id: $ref: '#/components/schemas/EntityId' balance: format: int64 type: integer nullable: true example: timestamp: '0.000002345' balance: 80 tokens: - token_id: 0.0.200001 balance: 8 TimestampNullable: description: A Unix timestamp in seconds.nanoseconds format type: string example: '1586567700.453054000' pattern: ^\d{1,10}(\.\d{1,9})?$ nullable: true EvmAddressNullable: type: string description: A network entity encoded as an EVM address in hex. format: binary minLength: 40 maxLength: 42 nullable: true pattern: ^(0x)?[A-Fa-f0-9]{40}$ example: '0x0000000000000000000000000000000000001f41' Key: description: The public key which controls access to various network entities. type: object nullable: true properties: _type: type: string enum: - ECDSA_SECP256K1 - ED25519 - ProtobufEncoded example: ProtobufEncoded key: type: string example: 15706b229b3ba33d4a5a41ff54ce1cfe0a3d308672a33ff382f81583e02bd743 Transaction: type: object properties: batch_key: $ref: '#/components/schemas/Key' bytes: type: string format: byte nullable: true charged_tx_fee: format: int64 type: integer consensus_timestamp: $ref: '#/components/schemas/Timestamp' entity_id: $ref: '#/components/schemas/EntityId' high_volume: description: >- Whether the transaction used high-volume entity creation throttles and pricing per HIP-1313 type: boolean high_volume_pricing_multiplier: description: >- 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. format: int64 minimum: 0 nullable: true type: integer max_custom_fees: type: array items: $ref: '#/components/schemas/CustomFeeLimit' max_fee: type: string memo_base64: type: string format: byte nullable: true name: $ref: '#/components/schemas/TransactionTypes' nft_transfers: type: array items: type: object properties: is_approval: type: boolean receiver_account_id: $ref: '#/components/schemas/EntityId' sender_account_id: $ref: '#/components/schemas/EntityId' serial_number: example: 1 format: int64 type: integer token_id: $ref: '#/components/schemas/EntityId' required: - is_approval - receiver_account_id - sender_account_id - token_id - serial_number node: $ref: '#/components/schemas/EntityId' nonce: type: integer minimum: 0 parent_consensus_timestamp: $ref: '#/components/schemas/TimestampNullable' result: type: string scheduled: type: boolean staking_reward_transfers: $ref: '#/components/schemas/StakingRewardTransfers' token_transfers: type: array items: type: object properties: token_id: $ref: '#/components/schemas/EntityId' account: $ref: '#/components/schemas/EntityId' amount: format: int64 type: integer is_approval: type: boolean required: - token_id - account - amount transaction_hash: type: string format: byte transaction_id: type: string transfers: type: array items: type: object properties: account: $ref: '#/components/schemas/EntityId' amount: format: int64 type: integer is_approval: type: boolean required: - account - amount valid_duration_seconds: type: string valid_start_timestamp: $ref: '#/components/schemas/Timestamp' example: batch_key: _type: ED25519 key: 7934a257a6144fabc8fbdeeaa5810662adb89e7b6978ace46a74fdb2d12bd4b2 bytes: null charged_tx_fee: 7 consensus_timestamp: '1234567890.000000007' entity_id: 0.0.2281979 high_volume: false high_volume_pricing_multiplier: 1 max_custom_fees: - account_id: 0.0.8 amount: 1000 denominating_token_id: 0.0.2000 - account_id: 0.0.8 amount: 1500 denominating_token_id: null max_fee: 33 memo_base64: null name: CRYPTOTRANSFER nft_transfers: - is_approval: true receiver_account_id: 0.0.121 sender_account_id: 0.0.122 serial_number: 1 token_id: 0.0.123 - is_approval: true receiver_account_id: 0.0.321 sender_account_id: 0.0.422 serial_number: 2 token_id: 0.0.123 node: 0.0.3 nonce: 0 parent_consensus_timestamp: '1234567890.000000007' result: SUCCESS scheduled: false staking_reward_transfers: - account: 3 amount: 150 - account: 9 amount: 200 transaction_hash: vigzKe2J7fv4ktHBbNTSzQmKq7Lzdq1/lJMmHT+a2KgvdhAuadlvS4eKeqKjIRmW transaction_id: 0.0.8-1234567890-000000006 token_transfers: - token_id: 0.0.90000 account: 0.0.9 amount: 1200 is_approval: false - token_id: 0.0.90000 account: 0.0.8 amount: -1200 is_approval: false transfers: - account: 0.0.3 amount: 2 is_approval: false - account: 0.0.8 amount: -3 is_approval: false - account: 0.0.98 amount: 1 is_approval: false - account: 0.0.800 amount: 150 is_approval: false - account: 0.0.800 amount: 200 is_approval: false valid_duration_seconds: 11 valid_start_timestamp: '1234567890.000000006' Timestamp: description: A Unix timestamp in seconds.nanoseconds format type: string example: '1586567700.453054000' pattern: ^\d{1,10}(\.\d{1,9})?$ CustomFeeLimit: type: object properties: account_id: $ref: '#/components/schemas/EntityId' amount: example: 100 format: int64 nullable: false type: integer denominating_token_id: $ref: '#/components/schemas/EntityId' StakingRewardTransfers: type: array items: $ref: '#/components/schemas/StakingRewardTransfer' StakingRewardTransfer: type: object description: A staking reward transfer required: - account - amount properties: account: $ref: '#/components/schemas/EntityId' amount: description: The number of tinybars awarded example: 10 format: int64 type: integer nullable: false example: account_id: 0.0.1000 amount: 10 responses: InvalidParameterError: description: Invalid parameter content: application/json: schema: $ref: '#/components/schemas/Error' example: _status: messages: - message: 'Invalid parameter: account.id' - message: >- Invalid Transaction id. Please use \shard.realm.num-sss-nnn\ format where sss are seconds and nnn are nanoseconds NotFoundError: description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error' example: _status: messages: - message: Not found ````