---
title: "Get token relationships info for an account"
method: GET
path: "/api/v1/accounts/{idOrAliasOrEvmAddress}/tokens"
tags: ["accounts"]
---

# Get token relationships info for an account

`GET /api/v1/accounts/{idOrAliasOrEvmAddress}/tokens`

Returns information for all token relationships for an account.

## Path parameters

- `idOrAliasOrEvmAddress` string, required

## Query parameters

- `limit` integer
- `order` 'asc' | 'desc'
- `token.id` string

## Response `200`

OK

- TokenRelationshipResponse
  - `tokens` TokenRelationship[]
    - `automatic_association` boolean, nullable, required — Specifies if the relationship is implicitly/explicitly associated.
    - `balance` integer, required — 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.
    - `created_timestamp` string, nullable, required — A Unix timestamp in seconds.nanoseconds format
    - `decimals` integer, nullable, required
    - `freeze_status` 'NOT_APPLICABLE' | 'FROZEN' | 'UNFROZEN', nullable, required — The Freeze status of the account.
    - `kyc_status` 'NOT_APPLICABLE' | 'GRANTED' | 'REVOKED', required — The KYC status of the account.
    - `token_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
  - `links` Links
    - `next` string, nullable

## Other responses

- `400` — Invalid parameter
- `404` — Not Found

## Changes

- **2026-07-09** (v1) `8ce3e9a7251e` — 4 breaking
  - the response property `tokens/items/automatic_association` became nullable for the status `200`
  - the response property `tokens/items/created_timestamp` became nullable for the status `200`
  - the response property `tokens/items/decimals` became nullable for the status `200`
  - the response property `tokens/items/freeze_status` became nullable for the status `200`
- **2025-08-08** (v1) `db389f03b097` — 6 breaking
  - the response property `_status/messages/items/data` became nullable for the status `400`
  - the response property `_status/messages/items/data` became nullable for the status `404`
  - the response property `_status/messages/items/detail` became nullable for the status `400`
  - the response property `_status/messages/items/detail` became nullable for the status `404`
  - …2 more

[Change history](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/changes/api/v1/accounts/:idOrAliasOrEvmAddress/tokens/get.md)

---

[API](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hiero-ledger/mirror-node-rest-api/revisions/ee602751b3f7/schema)