Fetch Accounts

Fetches a list of accounts based on the provided query. Please note that the output fields will be trimmed to a smaller set of fields if the detail-level path parameter is set to identifiers or compact. Available detail levels:

Filter & Sort Options

Usage example can be found here.

Supported filter and data types can be found here. Allowed values in the fieldName for sortModel and filterModel:

fieldName	dataType	description	sort
managed	BOOLEAN	Managed vs un-manged accounts	(DESC)^**
type	OFFCHAIN_REFRENCE_TYPE	The offchain reference type
code^*	TEXT	The offchain reference code
alId^*	TEXT	The offchain reference AL ID
accountNumber^*	TEXT	The offchain reference account number
externalOrganizationId^*	TEXT	The offchain reference external organization id
offchainReferenceName^*	TEXT	The offchain reference name
status	TEXT	Indicates if the account is ACTIVE or CLOSED
lamportsBalance^*	DECIMAL	Current offchain lamports balance
orgsIsGlobalFeePayerFor^*	TEXT	Organization external ids for which the account is a global fee payer for
orgsAllowedToSignWithPrivateKey^*	TEXT	Organization external ids for which their API Keys can use the private key of the account to sign transactions with it
lastTransactionAt^*	TIMESTAMP	Offchain timestamp of last transaction processed against this account
creationTransactionAt^*	TIMESTAMP	Offchain timestamp of creation transaction for this account
wasAlreadyOnchain	BOOLEAN	Indicates if the account was already on chain at the time of the account was onboarded into Vulcan Forge
privateKeyLocation^*	TEXT	Location of private key
canPayFees	BOOLEAN	Indicates if the account can pay Solana transaction and rent fees
sharedAccrossTenants^*	BOOLEAN	Indicates if the account is shared across tenants
comments^*	TEXT	The account's comments
tenantOrganizationId^*	TEXT	The external organization id associated with the blockchain account. This represents the tenant organization to which the API Key that created the account belongs to.

(ASC|DESC)^** - columns that are part of the default sort if no itemQuery.sortModel is provided.
^* - indicates columns that are nullable and can use the IS_NULL or IS_NOT_NULL type

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Header Params

Body Params application/json

Examples

curl --location 'https://vf-solana-api.dev.alphaledger.com/api/v1/accounts/bulk/compact?svmCluster=SOLANA_DEVNET' \ --header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "itemQuery": { "limit": 10, "skip": 0, "filter": [ { "fieldName": "See the endpoint description for allowed values", "operator": "AND", "filterValues": [ { "dataType": "TEXT", "filterType": "EQUALS", "valueString": "string", "valueNumber": 0, "valueBoolean": true, "valuesString": [ "string" ], "valueFromString": "string", "valueToString": "string", "valueFromNumber": 0, "valueToNumber": 0 } ] } ], "sort": [ { "fieldName": "See the endpoint description for allowed values", "sortDirection": "ASC" } ] }, "tenancyConfig": { "overrideOrganizationExternalId": "ALIM" } }'

Filter & Sort Options#

Request

Responses

Filter & Sort Options