Accounts

Get account info

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}

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

Changed in 4 of the 53 revisions of this API.2620

Jul 9, 202504a9a0b50aa334See the full diff
- ●
  deleted the path request parameter principal
  request-parameter-removed
- ●
  deleted the query request parameter proof
  request-parameter-removed
- ●
  deleted the query request parameter tip
  request-parameter-removed
- ○
  api operation id get_account_info removed and replaced with getAccountInfo
  api-operation-id-removed
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 8, 2025488dd3b8002016See the full diff
- ▲
  added the new path request parameter principal
  new-request-path-parameter
- ○
  api operation id getAccountInfo removed and replaced with get_account_info
  api-operation-id-removed
- ○
  added the new optional query request parameter proof
  new-optional-request-parameter
- ○
  added the new optional query request parameter tip
  new-optional-request-parameter
- ○
  removed the non-success response with the status
  response-non-success-status-removed
- ○
  removed the non-success response with the status
  response-non-success-status-removed
- ○
  removed the non-success response with the status
  response-non-success-status-removed
This revision also has 35 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 8, 2025170414634c9034See the full diff
- ●
  deleted the path request parameter principal
  request-parameter-removed
- ●
  deleted the query request parameter proof
  request-parameter-removed
- ●
  deleted the query request parameter tip
  request-parameter-removed
- ○
  api operation id get_account_info removed and replaced with getAccountInfo
  api-operation-id-removed
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 26, 20252fc5956efe3d16See the full diff
- ▲
  added the new path request parameter principal
  new-request-path-parameter
- ○
  api operation id getAccountInfo removed and replaced with get_account_info
  api-operation-id-removed
- ○
  added the new optional query request parameter proof
  new-optional-request-parameter
- ○
  added the new optional query request parameter tip
  new-optional-request-parameter
- ○
  removed the non-success response with the status
  response-non-success-status-removed
- ○
  removed the non-success response with the status
  response-non-success-status-removed
- ○
  removed the non-success response with the status
  response-non-success-status-removed
This revision also has 35 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history