Skip to main content
GET
/
v1
/
accounts
List accounts owned by a public key.
curl --request GET \
  --url https://rest.alphanet.thruput.org/v1/accounts
{
  "accounts": [
    {
      "address": {
        "value": "aSDinaTvuI8gbWludGxpZnk="
      },
      "meta": {
        "version": 123,
        "flags": {
          "isProgram": true,
          "isPrivileged": true,
          "isUncompressable": true,
          "isEphemeral": true,
          "isDeleted": true,
          "isNew": true,
          "isCompressed": true
        },
        "dataSize": 123,
        "stateCounter": "<string>",
        "owner": {
          "value": "aSDinaTvuI8gbWludGxpZnk="
        },
        "balance": "<string>",
        "nonce": "<string>"
      },
      "data": {
        "data": "aSDinaTvuI8gbWludGxpZnk=",
        "compressed": true,
        "compressionAlgorithm": "<string>"
      },
      "versionContext": {
        "slot": "<string>",
        "blockTimestamp": "2023-11-07T05:31:56Z"
      },
      "consensusStatus": "CONSENSUS_STATUS_UNSPECIFIED"
    }
  ],
  "page": {
    "nextPageToken": "<string>",
    "totalSize": "<string>"
  }
}

Query Parameters

​
owner.value
string<byte>
required

32-byte public key buffer.

​
view
enum<string>
default:ACCOUNT_VIEW_UNSPECIFIED
  • ACCOUNT_VIEW_UNSPECIFIED: ACCOUNT_VIEW_UNSPECIFIED uses service defaults.
  • ACCOUNT_VIEW_PUBKEY_ONLY: ACCOUNT_VIEW_PUBKEY_ONLY returns only the account address.
  • ACCOUNT_VIEW_META_ONLY: ACCOUNT_VIEW_META_ONLY returns only account metadata.
  • ACCOUNT_VIEW_DATA_ONLY: ACCOUNT_VIEW_DATA_ONLY returns only account data.
  • ACCOUNT_VIEW_FULL: ACCOUNT_VIEW_FULL returns address, metadata, and data.
Available options:
ACCOUNT_VIEW_UNSPECIFIED,
ACCOUNT_VIEW_PUBKEY_ONLY,
ACCOUNT_VIEW_META_ONLY,
ACCOUNT_VIEW_DATA_ONLY,
ACCOUNT_VIEW_FULL
​
versionContext.slot
string<uint64>

Request the version for a specific slot number.

​
versionContext.timestamp
string<date-time>

Request the version nearest to the provided block timestamp.

​
filter.expression
string

CEL expression applied server-side. Empty expressions are treated as no-op.

​
filter.params
string

Named parameter bindings for expression parameterization.

​
page.pageSize
integer

Maximum number of items to return in a single response.

​
page.pageToken
string

Token identifying the position to resume from.

​
page.orderBy
string

Optional ordering specification in "field [asc|desc]" form.

​
minConsensus
enum<string>
default:CONSENSUS_STATUS_UNSPECIFIED
  • CONSENSUS_STATUS_UNSPECIFIED: CONSENSUS_STATUS_UNSPECIFIED indicates the consensus status is unknown.
  • CONSENSUS_STATUS_OBSERVED: CONSENSUS_STATUS_OBSERVED indicates the resource has been observed but not yet confirmed in a finalized block.
  • CONSENSUS_STATUS_INCLUDED: CONSENSUS_STATUS_INCLUDED indicates the resource has been included in the ledger but may not be finalized.
  • CONSENSUS_STATUS_FINALIZED: CONSENSUS_STATUS_FINALIZED indicates the resource is finalized for a slot.
  • CONSENSUS_STATUS_LOCALLY_EXECUTED: CONSENSUS_STATUS_LOCALLY_EXECUTED indicates the local node executed the resource but broader cluster finality may not have been achieved.
  • CONSENSUS_STATUS_CLUSTER_EXECUTED: CONSENSUS_STATUS_CLUSTER_EXECUTED indicates the entire cluster has executed and agreed on the resource.
Available options:
CONSENSUS_STATUS_UNSPECIFIED,
CONSENSUS_STATUS_OBSERVED,
CONSENSUS_STATUS_INCLUDED,
CONSENSUS_STATUS_FINALIZED,
CONSENSUS_STATUS_LOCALLY_EXECUTED,
CONSENSUS_STATUS_CLUSTER_EXECUTED

Response

A successful response.

ListOwnedAccountsResponse contains paginated accounts.

​
accounts
object[]
​
page
object

PageResponse captures pagination metadata returned with list results.