Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hedera accounts API

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.

Hedera accounts API is one of 10 APIs that Hedera publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include accounts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 10 operations across 10 paths, and defines 42 schemas. It is described by OpenAPI 3.1.0, at version 0.156.0.

Requests are made against a single base URL, {scheme}://{network}.mirrornode.hedera.com.

10 operations 10 paths 42 schemas 10 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.156.0
Base URL
https://mainnet.mirrornode.hedera.com
License
Resource Areas
1

Paths & Operations 10

Across 10 paths, the API surfaces 10 operations — 10 GET. Each is listed below with its method, path, parameters, and response codes.

accounts 10

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…

GET
/api/v1/accounts
List account entities on network
getAccounts 6 params → 200400
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}
Get account by alias, id, or evm address
getAccount 6 params → 200400404
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}/hooks
List hooks for an account
getHooks 4 params → 200400404
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}/hooks/{hookId}/storage
Get hook storage slots
getHookStorage 6 params → 200400404
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}/nfts
Get nfts for an account info
getNftsByAccountId 6 params → 200400404
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}/rewards
Get past staking reward payouts for an account
getStakingRewards 4 params → 200400404
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}/tokens
Get token relationships info for an account
getTokensByAccountId 4 params → 200400404
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}/allowances/crypto
Get crypto allowances for an account info
getCryptoAllowances 4 params → 200400404
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}/allowances/tokens
Get fungible token allowances for an account
getTokenAllowances 5 params → 200400404
GET
/api/v1/accounts/{idOrAliasOrEvmAddress}/allowances/nfts
Get non fungible token allowances for an account
getNftAllowances 6 params → 200400404

Schemas 42

The contract defines 42 schemas that model the data the API accepts and returns. The most detailed are Transaction (24 properties), AccountInfo (18 properties), Nft (9 properties), Hook (9 properties). Each schema is shown below with its type and property counts.

TokenAllowances
array
EntityIdQuery
string
Balance
objectnull
3 properties 3 required
Nft
object
9 properties
StakingRewardsResponse
object
2 properties
Nfts
object
2 properties
AccountsResponse
object
2 properties 2 required
Hook
object
9 properties 9 required
TokenAllowancesResponse
object
2 properties
Key
objectnull
The public key which controls access to various network entities.
2 properties
CryptoAllowance
TokenRelationshipResponse
object
2 properties
HookStorage
object
3 properties 3 required
Allowance
object
5 properties
AccountBalanceTransactions
TimestampRange
object
A timestamp range an entity is valid for
2 properties
TimestampNullable
stringnull
A Unix timestamp in seconds.nanoseconds format
CryptoAllowances
array
CryptoAllowancesResponse
object
2 properties
TokenAllowance
AccountInfo
object
18 properties 17 required
HooksStorageResponse
object
4 properties 4 required
TransactionTypes
string
Alias
stringnull
RFC4648 no-padding base32 encoded account alias
Links
object
1 property
HooksResponse
object
2 properties 2 required
Transactions
array
EntityId
stringnull
Network entity ID in the format of shard.realm.num
StakingRewardTransfer
object
A staking reward transfer
2 properties 2 required
NftAllowances
array
CustomFeeLimit
object
3 properties
TokenRelationship
object
7 properties 7 required
NftAllowance
object
5 properties 5 required
NftAllowancesResponse
object
2 properties
Timestamp
string
A Unix timestamp in seconds.nanoseconds format
StakingRewardTransfers
array
Transaction
object
24 properties
Accounts
array
StakingReward
object
3 properties 3 required
Error
object
1 property
EvmAddressNullable
stringnull
A network entity encoded as an EVM address in hex.
TimestampRangeNullable
objectnull
A timestamp range an entity is valid for
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hedera-accounts-api-openapi.yml Raw ↑

Other APIs Hedera publishes across the network.

Hedera airdrops API
Hedera balances API
Hedera blocks API
Hedera contracts API
Hedera network API
Hedera schedules API
Hedera tokens API
Hedera topics API
Hedera transactions API