---
title: "Get holders of a token"
method: GET
path: "/{chainId}/holders/{address}"
tags: ["holders"]
---

# Get holders of a token

`GET /{chainId}/holders/{address}`

Retrieve holders of a token

## Path parameters

- `chainId` string, required
- `address` string, required

## Query parameters

- `token_type` string
- `hide_zero_balances` boolean, required
- `page` integer
- `limit` integer

## Response `200`

OK

- object — QueryResponse represents the response structure for a query
  - `aggregations` object[] — @Description Aggregation results
  - `data` HandlersHolderModel[] — @Description Query result data
    - `balance` string
    - `holder_address` string
    - `token_id` string
    - `token_type` string
  - `meta` ApiMeta — Meta represents metadata for a query response
    - `address` string — @Description Contract address
    - `chain_id` integer — @Description Chain ID of the blockchain
    - `limit` integer — @Description Number of items per page
    - `page` integer — @Description Current page number
    - `signature` string — @Description Function or event signature
    - `total_items` integer — @Description Total number of items
    - `total_pages` integer — @Description Total number of pages

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/thirdweb/apis/thirdweb-insight.md) · [All operations](https://skmtc.net/thirdweb/apis/thirdweb-insight/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thirdweb/thirdweb-insight/versions/a0a466ab88d5/schema)