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.

OpenAPI Specification

hedera-accounts-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Mirror Node REST accounts API
  version: 0.156.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
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
paths:
  /api/v1/accounts:
    get:
      summary: List account entities on network
      description: Returns a list of all account entity items on the network.
      operationId: getAccounts
      parameters:
      - $ref: '#/components/parameters/accountBalanceQueryParam'
      - $ref: '#/components/parameters/accountIdQueryParam'
      - $ref: '#/components/parameters/accountPublicKeyQueryParam'
      - $ref: '#/components/parameters/balanceQueryParam'
      - $ref: '#/components/parameters/limitQueryParam'
      - $ref: '#/components/parameters/orderQueryParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountsResponse'
        '400':
          $ref: '#/components/responses/InvalidParameterError'
      tags:
      - accounts
  /api/v1/accounts/{idOrAliasOrEvmAddress}:
    get:
      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'
      tags:
      - accounts
  /api/v1/accounts/{idOrAliasOrEvmAddress}/hooks:
    get:
      summary: List hooks for an account
      description: Returns a list of hooks associated with a given account ID, alias, or EVM address.
      operationId: getHooks
      parameters:
      - $ref: '#/components/parameters/accountIdOrAliasOrEvmAddressPathParam'
      - $ref: '#/components/parameters/hookIdQueryParam'
      - $ref: '#/components/parameters/limitQueryParam'
      - $ref: '#/components/parameters/orderQueryParamDesc'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HooksResponse'
        '400':
          $ref: '#/components/responses/InvalidParameterError'
        '404':
          $ref: '#/components/responses/NotFoundError'
      tags:
      - accounts
  /api/v1/accounts/{idOrAliasOrEvmAddress}/hooks/{hookId}/storage:
    get:
      summary: Get hook storage slots
      description: Returns a list of hook storage slots associated with a given hook.
      operationId: getHookStorage
      parameters:
      - $ref: '#/components/parameters/accountIdOrAliasOrEvmAddressPathParam'
      - $ref: '#/components/parameters/hookIdPathParam'
      - $ref: '#/components/parameters/keyQueryParam'
      - $ref: '#/components/parameters/limitQueryParam'
      - $ref: '#/components/parameters/orderQueryParam'
      - $ref: '#/components/parameters/timestampQueryParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HooksStorageResponse'
        '400':
          $ref: '#/components/responses/InvalidParameterError'
        '404':
          $ref: '#/components/responses/NotFoundError'
      tags:
      - accounts
  /api/v1/accounts/{idOrAliasOrEvmAddress}/nfts:
    get:
      summary: Get nfts for an account info
      description: 'Returns information for all non-fungible tokens for an account.


        ## Ordering

        When considering NFTs, their order is governed by a combination of their numerical **token.Id** and **serialnumber** values, with **token.id** being the parent column.

        A serialnumbers value governs its order within the given token.id


        In that regard, if a user acquired a set of NFTs in the order (2-2, 2-4 1-5, 1-1, 1-3, 3-3, 3-4), the following layouts illustrate the ordering expectations for ownership listing

        1. **All NFTs in ASC order**: 1-1, 1-3, 1-5, 2-2, 2-4, 3-3, 3-4

        2. **All NFTs in DESC order**: 3-4, 3-3, 2-4, 2-2, 1-5, 1-3, 1-1

        3. **NFTs above 1-1 in ASC order**: 1-3, 1-5, 2-2, 2-4, 3-3, 3-4

        4. **NFTs below 3-3 in ASC order**: 1-1, 1-3, 1-5, 2-2, 2-4

        5. **NFTs between 1-3 and 3-3 inclusive in DESC order**: 3-4, 3-3, 2-4, 2-2, 1-5, 1-3


        Note: The default order for this API is currently DESC


        ## Filtering

        When filtering there are some restrictions enforced to ensure correctness and scalability.


        **The table below defines the restrictions and support for the NFT ownership endpoint**


        | Query Param   | Comparison Operator | Support | Description           | Example |

        | ------------- | ------------------- | ------- | --------------------- | ------- |

        | token.id      | eq                  | Y       | Single occurrence only. | ?token.id=X |

        |               | ne                  | N       | | |

        |               | lt(e)               | Y       | Single occurrence only. | ?token.id=lte:X |

        |               | gt(e)               | Y       | Single occurrence only. | ?token.id=gte:X |

        | serialnumber  | eq                  | Y       | Single occurrence only. Requires the presence of a **token.id** query | ?serialnumber=Y |

        |               | ne                  | N       | | |

        |               | lt(e)               | Y       | Single occurrence only. Requires the presence of an **lte** or **eq** **token.id** query | ?token.id=lte:X&serialnumber=lt:Y |

        |               | gt(e)               | Y       | Single occurrence only. Requires the presence of an **gte** or **eq** **token.id** query | ?token.id=gte:X&serialnumber=gt:Y |

        | spender.id    | eq                  | Y       | | ?spender.id=Z |

        |               | ne                  | N       | | |

        |               | lt(e)               | Y       | | ?spender.id=lt:Z |

        |               | gt(e)               | Y       | | ?spender.id=gt:Z |


        Note: When searching across a range for individual NFTs a **serialnumber** with an additional **token.id** query filter must be provided.

        Both filters must be a single occurrence of **gt(e)** or **lt(e)** which provide a lower and or upper boundary for search.

        '
      operationId: getNftsByAccountId
      parameters:
      - $ref: '#/components/parameters/accountIdOrAliasOrEvmAddressPathParam'
      - $ref: '#/components/parameters/limitQueryParam'
      - $ref: '#/components/parameters/orderQueryParamDesc'
      - $ref: '#/components/parameters/serialNumberQueryParam'
      - $ref: '#/components/parameters/spenderIdQueryParam'
      - $ref: '#/components/parameters/tokenIdQueryParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Nfts'
        '400':
          $ref: '#/components/responses/InvalidParameterError'
        '404':
          $ref: '#/components/responses/NotFoundError'
      tags:
      - accounts
  /api/v1/accounts/{idOrAliasOrEvmAddress}/rewards:
    get:
      summary: Get past staking reward payouts for an account
      description: 'Returns information for all past staking reward payouts for an account.

        '
      operationId: getStakingRewards
      parameters:
      - $ref: '#/components/parameters/accountIdOrAliasOrEvmAddressPathParam'
      - $ref: '#/components/parameters/limitQueryParam'
      - $ref: '#/components/parameters/orderQueryParamDesc'
      - $ref: '#/components/parameters/timestampQueryParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StakingRewardsResponse'
        '400':
          $ref: '#/components/responses/InvalidParameterError'
        '404':
          $ref: '#/components/responses/NotFoundError'
      tags:
      - accounts
  /api/v1/accounts/{idOrAliasOrEvmAddress}/tokens:
    get:
      summary: Get token relationships info for an account
      description: 'Returns information for all token relationships for an account.

        '
      operationId: getTokensByAccountId
      parameters:
      - $ref: '#/components/parameters/accountIdOrAliasOrEvmAddressPathParam'
      - $ref: '#/components/parameters/limitQueryParam'
      - $ref: '#/components/parameters/orderQueryParam'
      - $ref: '#/components/parameters/tokenIdQueryParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenRelationshipResponse'
        '400':
          $ref: '#/components/responses/InvalidParameterError'
        '404':
          $ref: '#/components/responses/NotFoundError'
      tags:
      - accounts
  /api/v1/accounts/{idOrAliasOrEvmAddress}/allowances/crypto:
    get:
      summary: Get crypto allowances for an account info
      description: Returns information for all crypto allowances for an account.
      operationId: getCryptoAllowances
      parameters:
      - $ref: '#/components/parameters/accountIdOrAliasOrEvmAddressPathParam'
      - $ref: '#/components/parameters/limitQueryParam'
      - $ref: '#/components/parameters/orderQueryParamDesc'
      - $ref: '#/components/parameters/spenderIdQueryParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CryptoAllowancesResponse'
        '400':
          $ref: '#/components/responses/InvalidParameterError'
        '404':
          $ref: '#/components/responses/NotFoundError'
      tags:
      - accounts
  /api/v1/accounts/{idOrAliasOrEvmAddress}/allowances/tokens:
    get:
      summary: Get fungible token allowances for an account
      description: 'Returns information for fungible token allowances for an account.


        ## Ordering

        The order is governed by a combination of the spender id and the token id values, with spender id being the parent column.

        The token id value governs its order within the given spender id.


        Note: The default order for this API is currently ASC


        ## Filtering

        When filtering there are some restrictions enforced to ensure correctness and scalability.


        **The table below defines the restrictions and support for the endpoint**


        | Query Param   | Comparison Operator | Support | Description           | Example |

        | ------------- | ------------------- | ------- | --------------------- | ------- |

        | spender.id    | eq                  | Y       | Single occurrence only. | ?spender.id=X |

        |               | ne                  | N       | | |

        |               | lt(e)               | Y       | Single occurrence only. | ?spender.id=lte:X |

        |               | gt(e)               | Y       | Single occurrence only. | ?spender.id=gte:X |

        | token.id      | eq                  | Y       | Single occurrence only. Requires the presence of a **spender.id** query | ?token.id=lt:Y |

        |               | ne                  | N       | | |

        |               | lt(e)               | Y       | Single occurrence only. Requires the presence of an **lte** or **eq** **spender.id** query | ?spender.id=lte:X&token.id=lt:Y |

        |               | gt(e)               | Y       | Single occurrence only. Requires the presence of an **gte** or **eq** **spender.id** query | ?spender.id=gte:X&token.id=gt:Y |


        Both filters must be a single occurrence of **gt(e)** or **lt(e)** which provide a lower and or upper boundary for search.

        '
      operationId: getTokenAllowances
      parameters:
      - $ref: '#/components/parameters/accountIdOrAliasOrEvmAddressPathParam'
      - $ref: '#/components/parameters/limitQueryParam'
      - $ref: '#/components/parameters/orderQueryParam'
      - $ref: '#/components/parameters/spenderIdQueryParam'
      - $ref: '#/components/parameters/tokenIdQueryParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenAllowancesResponse'
        '400':
          $ref: '#/components/responses/InvalidParameterError'
        '404':
          $ref: '#/components/responses/NotFoundError'
      tags:
      - accounts
  /api/v1/accounts/{idOrAliasOrEvmAddress}/allowances/nfts:
    get:
      summary: Get non fungible token allowances for an account
      description: 'Returns an account''s non-fungible token allowances.


        ## Ordering

        The order is governed by a combination of the account ID and the token ID values, with account ID being the parent column.

        The token ID value governs its order within the given account ID.


        Note: The default order for this API is currently ascending. The account ID can be the owner or the spender ID depending upon the owner flag.


        ## Filtering

        When filtering there are some restrictions enforced to ensure correctness and scalability.


        **The table below defines the restrictions and support for the endpoint**


        | Query Param   | Comparison Operator | Support | Description           | Example |

        | ------------- | ------------------- | ------- | --------------------- | ------- |

        | account.id    | eq                  | Y       | Single occurrence only. | ?account.id=X |

        |               | ne                  | N       | | |

        |               | lt(e)               | Y       | Single occurrence only. | ?account.id=lte:X |

        |               | gt(e)               | Y       | Single occurrence only. | ?account.id=gte:X |

        | token.id      | eq                  | Y       | Single occurrence only. Requires the presence of an **account.id** parameter | ?account.id=X&token.id=eq:Y |

        |               | ne                  | N       | | |

        |               | lt(e)               | Y       | Single occurrence only. Requires the presence of an **lte** or **eq** **account.id** parameter | ?account.id=lte:X&token.id=lt:Y |

        |               | gt(e)               | Y       | Single occurrence only. Requires the presence of an **gte** or **eq** **account.id** parameter | ?account.id=gte:X&token.id=gt:Y |


        Both filters must be a single occurrence of **gt(e)** or **lt(e)** which provide a lower and or upper boundary for search.

        '
      operationId: getNftAllowances
      parameters:
      - $ref: '#/components/parameters/accountIdOrAliasOrEvmAddressPathParam'
      - $ref: '#/components/parameters/limitQueryParam'
      - $ref: '#/components/parameters/orderQueryParam'
      - $ref: '#/components/parameters/accountIdQueryParam'
      - $ref: '#/components/parameters/tokenIdQueryParam'
      - $ref: '#/components/parameters/ownerQueryParam'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NftAllowancesResponse'
        '400':
          $ref: '#/components/responses/InvalidParameterError'
        '404':
          $ref: '#/components/responses/NotFoundError'
      tags:
      - accounts
components:
  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
  schemas:
    TokenAllowances:
      type: array
      items:
        $ref: '#/components/schemas/TokenAllowance'
    EntityIdQuery:
      type: string
      pattern: ^((gte?|lte?|eq|ne)\:)?(\d{1,10}\.\d{1,10}\.)?\d{1,10}$
    Balance:
      type:
      - object
      - 'null'
      required:
      - timestamp
      - balance
      - tokens
      properties:
        timestamp:
          $ref: '#/components/schemas/TimestampNullable'
        balance:
          format: int64
          type:
          - integer
          - 'null'
        tokens:
          type: array
          items:
            type: object
            properties:
              token_id:
                $ref: '#/components/schemas/EntityId'
              balance:
                format: int64
                type: integer
      example:
        timestamp: '0.000002345'
        balance: 80
        tokens:
        - token_id: 0.0.200001
          balance: 8
    Nft:
      type: object
      properties:
        account_id:
          $ref: '#/components/schemas/EntityId'
        created_timestamp:
          $ref: '#/components/schemas/TimestampNullable'
        delegating_spender:
          $ref: '#/components/schemas/EntityId'
        deleted:
          description: whether the nft or the token it belongs to has been deleted
          type: boolean
        metadata:
          description: Arbitrary binary data associated with this NFT encoded in base64.
          type: string
          format: byte
        modified_timestamp:
          $ref: '#/components/schemas/TimestampNullable'
        serial_number:
          example: 1
          format: int64
          type: integer
        spender:
          $ref: '#/components/schemas/EntityId'
        token_id:
          $ref: '#/components/schemas/EntityId'
      example:
        account_id: 0.1.2
        created_timestamp: '1234567890.000000001'
        delegating_spender: 0.0.400
        deleted: false
        metadata: VGhpcyBpcyBhIHRlc3QgTkZU
        modified_timestamp: '1610682445.003266001'
        serial_number: 124
        spender_id: 0.0.500
        token_id: 0.0.222
    StakingRewardsResponse:
      type: object
      properties:
        rewards:
          type: array
          items:
            $ref: '#/components/schemas/StakingReward'
        links:
          $ref: '#/components/schemas/Links'
    Nfts:
      type: object
      properties:
        nfts:
          type: array
          items:
            $ref: '#/components/schemas/Nft'
        links:
          $ref: '#/components/schemas/Links'
    AccountsResponse:
      type: object
      required:
      - accounts
      - links
      properties:
        accounts:
          $ref: '#/components/schemas/Accounts'
        links:
          $ref: '#/components/schemas/Links'
    Hook:
      type: object
      required:
      - admin_key
      - contract_id
      - created_timestamp
      - deleted
      - extension_point
      - hook_id
      - owner_id
      - timestamp_range
      - type
      properties:
        admin_key:
          $ref: '#/components/schemas/Key'
        contract_id:
          allOf:
          - $ref: '#/components/schemas/EntityId'
          description: The contract entity that contains the hook's executing bytecode
        created_timestamp:
          allOf:
          - $ref: '#/components/schemas/TimestampNullable'
          description: The consensus timestamp when the hook was created
        deleted:
          description: Whether the hook has been deleted
          example: false
          type: boolean
        extension_point:
          description: The extension point this hook implements
          enum:
          - ACCOUNT_ALLOWANCE_HOOK
          example: ACCOUNT_ALLOWANCE_HOOK
          type: string
        hook_id:
          description: The unique identifier for the hook within the owner's scope
          example: 1
          format: int64
          type: integer
        owner_id:
          allOf:
          - $ref: '#/components/schemas/EntityId'
          description: The entity that owns the hook
        timestamp_range:
          $ref: '#/components/schemas/TimestampRangeNullable'
        type:
          description: The type of the hook implementation
          enum:
          - EVM
          example: EVM
          type: string
    TokenAllowancesResponse:
      type: object
      properties:
        allowances:
          $ref: '#/components/schemas/TokenAllowances'
        links:
          $ref: '#/components/schemas/Links'
    Key:
      description: The public key which controls access to various network entities.
      type:
      - object
      - 'null'
      properties:
        _type:
          type: string
          enum:
          - ECDSA_SECP256K1
          - ED25519
          - ProtobufEncoded
          example: ProtobufEncoded
        key:
          type: string
          example: 15706b229b3ba33d4a5a41ff54ce1cfe0a3d308672a33ff382f81583e02bd743
    CryptoAllowance:
      allOf:
      - $ref: '#/components/schemas/Allowance'
      - properties:
          amount:
            description: The amount remaining of the original amount granted in tinybars.
            type: integer
            format: int64
          amount_granted:
            description: The granted amount of the spender's allowance in tinybars.
            type: integer
            format: int64
    TokenRelationshipResponse:
      type: object
      properties:
        tokens:
          type: array
          items:
            $ref: '#/components/schemas/TokenRelationship'
        links:
          $ref: '#/components/schemas/Links'
    HookStorage:
      type: object
      required:
      - key
      - timestamp
      - value
      properties:
        key:
          example: '0x00000000000000000000000000000000000000000000000000000000000f9a17'
          format: binary
          type: string
        value:
          example: '0x00000000000000000000000000000000000000000000000000000000000f9a17'
          format: binary
          type:
          - string
          - 'null'
        timestamp:
          $ref: '#/components/schemas/Timestamp'
    Allowance:
      type: object
      properties:
        amount:
          description: The amount remaining of the original amount granted.
          format: int64
          type: integer
          example: 75
        amount_granted:
          description: The granted amount of the spender's allowance.
          format: int64
          type: integer
          example: 100
        owner:
          $ref: '#/components/schemas/EntityId'
        spender:
          $ref: '#/components/schemas/EntityId'
        timestamp:
          $ref: '#/components/schemas/TimestampRange'
    AccountBalanceTransactions:
      allOf:
      - $ref: '#/components/schemas/AccountInfo'
      - type: object
        required:
        - transactions
        - links
        properties:
          transactions:
            $ref: '#/components/schemas/Transactions'
          links:
            $ref: '#/components/schemas/Links'
    TimestampRange:
      type: object
      description: A timestamp range an entity is valid for
      properties:
        from:
          allOf:
          - $ref: '#/components/schemas/Timestamp'
          - description: The inclusive from timestamp in seconds
        to:
          allOf:
          - $ref: '#/components/schemas/TimestampNullable'
          - description: The exclusive to timestamp in seconds
    TimestampNullable:
      description: A Unix timestamp in seconds.nanoseconds format
      type:
      - string
      - 'null'
      example: '1586567700.453054000'
      pattern: ^\d{1,10}(\.\d{1,9})?$
    CryptoAllowances:
      type: array
      items:
        $ref: '#/components/schemas/CryptoAllowance'
    CryptoAllowancesResponse:
      type: object
      properties:
        allowances:
          $ref: '#/components/schemas/CryptoAllowances'
        links:
          $ref: '#/components/schemas/Links'
    TokenAllowance:
      allOf:
      - $ref: '#/components/schemas/Allowance'
      - properties:
          token_id:
            $ref: '#/components/schemas/EntityId'
    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
          - 'null'
          format: int64
        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
          - 'null'
        ethereum_nonce:
          type:
          - integer
          - 'null'
          format: int64
        evm_address:
          $ref: '#/components/schemas/EvmAddressNullable'
        expiry_timestamp:
          $ref: '#/components/schemas/TimestampNullable'
        key:
          $ref: '#/components/schemas/Key'
        max_automatic_token_associations:
          type:
          - integer
          - 'null'
          format: int32
        memo:
          type:
          - string
          - 'null'
        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
          - 'null'
        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
          - 'null'
          format: int64
        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'
    HooksStorageResponse:
      type: object
      required:
      - hook_id
      - links
      - owner_id
      - storage
      properties:
        hook_id:
          description: The unique identifier of the hook within the owner's scope
          example: 1
          format: int64
          type: integer
        links:
          $ref: '#/components/schemas/Links'
        owner_id:
          allOf:
          - $ref: '#/components/schemas/EntityId'
          - description: The entity that owns the hook
        storage:
          type: array
          items:
            $ref: '#/components/schemas/HookStorage'
    TransactionTypes:
      type: string
      enum:
      - ATOMICBATCH
      - CONSENSUSCREATETOPIC
      - CONSENSUSDELETETOPIC
      - CONSENSUSSUBMITMESSAGE
      - CONSENSUSUPDATETOPIC
      - CONTRACTCALL
      - CONTRACTCREATEINSTANCE
      - CONTRACTDELETEINSTANCE
      - CONTRACTUPDATEINSTANCE
      - CRSPUBLICATION
      - CRYPTOADDLIVEHASH
      - CRYPTOAPPROVEALLOWANCE
      - CRYPTOCREATEACCOUNT
      - CRYPTODELETE
      - CRYPTODELETEALLOWANCE
      - CRYPTODELETELIVEHASH
      - CRYPTOTRANSFER
      - CRYPTOUPDATEACCOUNT
      - ETHEREUMTRANSACTION
      - FILEAPPEND
      - FILECREATE
      - FILEDELETE
      - FILEUPDATE
      - FREEZE
      - HINTSKEYPUBLICATION
      - HINTSPARTIALSIGNATURE
      - HINTSPREPROCESSINGVOTE
      - HISTORYPROOFKEYPUBLICATION
      - HISTORYPROOFSIGNATURE
      - HISTORYPROOFVOTE
      - HOOKSTORE
      - LEDGERIDPUBLICATION
      - MIGRATIONROOTHASHVOTE
      - NODECREATE
      - NODEDELETE
      - NODESTAKEUPDATE
      - NODEUPDATE
      - REGISTEREDNODECREATE
      - REGISTEREDNODEDELETE
      - REGISTEREDNODEUPDATE
      - SCHEDULECREATE
      - SCHEDULEDELETE
      - SCHEDULESIGN
      - STATESIGNATURETRANSACTION
      - SYSTEMDELETE
      - SYSTEMUNDELETE
      - TOKENAIRDROP
      - TOKENASSOCIATE
      - TOKENBURN
      - TOKENCANCELAIRDROP
      - TOKENCLAIMAIRDROP
      - TOKENCREATION
      - TOKENDELETION
      - TOKENDISSOCIATE
      - TOKENFEESCHEDULEUPDATE
      - TOKENFREEZE
      - TOKENGRANTKYC
      - TOKENMINT
      - TOKENPAUSE
      - TOKENREJECT
      - TOKENREVOKEKYC
      - TOKENUNFREEZE
      - TOKENUNPAUSE
      - TOKENUPDATE
      - TOKENUPDATENFTS
      - TOKENWIPE
      - UNCHECKEDSUBMIT
      - UTILPRNG
    Alias:
      description: RFC4648 no-padding base32 encoded account alias
      type:
      - string
      - 'null'
      pattern: ^(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8})$
      example: HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA
    Links:

# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hedera/refs/heads/main/openapi/hedera-accounts-api-openapi.yml