Accounts

Get account info

Changed on

Get the account data for the provided principal

Where balance is the hex encoding of a unsigned 128-bit integer (big-endian), nonce is a unsigned 64-bit integer, and the proofs are provided as hex strings.

For non-existent accounts, this does not 404, rather it returns an object with balance and nonce of 0.

get/v2/accounts/{principal}

Request

  • Base URL
    http://localhost:20443
  • URL
    http://localhost:20443/v2/accounts/{principal}
  • Auth
    none required

Parameters

./components/parameters/principal.yaml (unresolved $ref)
./components/parameters/proof.yaml (unresolved $ref)
./components/parameters/tip.yaml (unresolved $ref)

Response

Success

AccountData required(unresolved $ref)

Changes

  • 04a9a0b50aa3Revision changes
    • warning

      deleted the path request parameter principal

    • warning

      deleted the query request parameter proof

    • warning

      deleted the query request parameter tip

    • info

      api operation id get_account_info removed and replaced with getAccountInfo

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 488dd3b80020Revision changes
    • breaking

      added the new path request parameter principal

    • info

      api operation id getAccountInfo removed and replaced with get_account_info

    • info

      added the new optional query request parameter proof

    • info

      added the new optional query request parameter tip

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status