1 of 1

Get Token Relationships by Account

Returns information for all token relationships for an account.

This method will use 15 Compute Units.

Get Token Relationships by Account

Returns information for all token relationships for an account.

This method will use 15 Compute Units.

Get token relationships info for an account

Returns information for all token relationships for an account.

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/accounts/{idOrAliasOrEvmAddress}/tokens

Path parameters

idOrAliasOrEvmAddress*string

Account alias or account id or evm address

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40}|(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8}))$

Query parameters

limitinteger (int32)

The maximum number of items to return

Example: 2

orderenum

The order in which items are listed

Example: "desc"

ascdesc

token.idEntityIdQuery (string)

The ID of the token to return information for

Pattern: ^((gte?|lte?|eq|ne)\:)?(\d{1,10}\.\d{1,10}\.)?\d{1,10}$

Response

Body

tokensarray of TokenRelationship (object)

automatic_association*boolean

Specifies if the relationship is implicitly/explicitly associated.

Example: true

balance*integer (int64)

For FUNGIBLE_COMMON, the balance that the account holds in the smallest denomination. For NON_FUNGIBLE_UNIQUE, the number of NFTs held by the account.

Example: 5

created_timestamp*Timestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

freeze_status*enum

The Freeze status of the account.

Example: "UNFROZEN"

NOT_APPLICABLEFROZENUNFROZEN

kyc_status*enum

The KYC status of the account.

Example: "GRANTED"

NOT_APPLICABLEGRANTEDREVOKED

token_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

linksLinks (object)

nextnullable string

Example: "/api/v1/transactions?timestamp=lt:1657598275.517984411"

Request

Response

Get token relationships info for an account

Returns information for all token relationships for an account.

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/accounts/{idOrAliasOrEvmAddress}/tokens

Path parameters

idOrAliasOrEvmAddress*string

Account alias or account id or evm address

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40}|(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8}))$

Query parameters

limitinteger (int32)

The maximum number of items to return

Example: 2

orderenum

The order in which items are listed

Example: "desc"

ascdesc

token.idEntityIdQuery (string)

The ID of the token to return information for

Pattern: ^((gte?|lte?|eq|ne)\:)?(\d{1,10}\.\d{1,10}\.)?\d{1,10}$

Response

Body

tokensarray of TokenRelationship (object)

automatic_association*boolean

Specifies if the relationship is implicitly/explicitly associated.

Example: true

balance*integer (int64)

For FUNGIBLE_COMMON, the balance that the account holds in the smallest denomination. For NON_FUNGIBLE_UNIQUE, the number of NFTs held by the account.

Example: 5

created_timestamp*Timestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

freeze_status*enum

The Freeze status of the account.

Example: "UNFROZEN"

NOT_APPLICABLEFROZENUNFROZEN

kyc_status*enum

The KYC status of the account.

Example: "GRANTED"

NOT_APPLICABLEGRANTEDREVOKED

token_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

linksLinks (object)

nextnullable string

Example: "/api/v1/transactions?timestamp=lt:1657598275.517984411"

Request

Response

const response = await fetch('https://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/accounts/{idOrAliasOrEvmAddress}/tokens', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

{
  "tokens": [
    {
      "automatic_association": true,
      "balance": 5,
      "created_timestamp": 123456789,
      "freeze_status": "UNFROZEN",
      "kyc_status": "GRANTED",
      "token_id": "0.0.27335"
    }
  ],
  "links": {
    "next": "/api/v1/transactions?timestamp=lt:1657598275.517984411"
  }
}