---
title: "List collectible (ERC-721/ERC-1155) balances"
method: GET
path: "/v1/chains/{chainId}/addresses/{address}/balances:listCollectibles"
tags: ["EVM Balances"]
---

# List collectible (ERC-721/ERC-1155) balances

`GET /v1/chains/{chainId}/addresses/{address}/balances:listCollectibles`

## Request

- Base URL: `https://data-api.avax.network`
- URL: `https://data-api.avax.network/v1/chains/{chainId}/addresses/{address}/balances:listCollectibles`
- Auth: one of:
  - API key in header `x-glacier-api-key`
  - none
- TypeScript: <https://skmtc.dev/avax/apis/data-api/docs/v1/chains/:chainId/addresses/:address/balances:listCollectibles/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists ERC-721 and ERC-1155 token balances of a wallet address.

Balance for a specific contract can be retrieved with the `contractAddress` parameter.

## Path parameters

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

## Query parameters

- `pageToken` string
- `pageSize` integer
- `contractAddress` string

## Response `200`

Successful response

- ListCollectibleBalancesResponse
  - `nextPageToken` string: A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.
  - `collectibleBalances` union[], required: The list of ERC-721 and ERC-1155 token balances for the address.
    - union
      - Erc721TokenBalance
        - `address` string, required: A wallet or contract address in mixed-case checksum encoding.
        - `name` string, required: The contract name.
        - `symbol` string, required: The contract symbol.
        - `ercType` 'ERC-721', required
        - `tokenId` string, required
        - `tokenUri` string, required
        - `metadata` Erc721TokenMetadata, required
          - `indexStatus` 'UNKNOWN' | 'MISSING_TOKEN' | 'INVALID_TOKEN_URI' | 'INVALID_TOKEN_URI_SCHEME' | 'UNREACHABLE_TOKEN_URI' | 'THROTTLED_TOKEN_URI' | 'METADATA_CONTENT_TOO_LARGE' | 'INVALID_METADATA' | 'INVALID_METADATA_JSON' | 'INDEXED' | 'UNINDEXED', required: The metadata indexing status of the nft.
          - `metadataLastUpdatedTimestamp` number
          - `name` string
          - `symbol` string
          - `imageUri` string
          - `description` string
          - `animationUri` string
          - `externalUrl` string
          - `background` string
          - `attributes` string
        - `ownerAddress` string: A wallet or contract address in mixed-case checksum encoding.
        - `chainId` string, required: The evm chain id.
      - Erc1155TokenBalance
        - `address` string, required: A wallet or contract address in mixed-case checksum encoding.
        - `ercType` 'ERC-1155', required
        - `tokenId` string, required
        - `tokenUri` string, required
        - `metadata` Erc1155TokenMetadata, required
          - `indexStatus` 'UNKNOWN' | 'MISSING_TOKEN' | 'INVALID_TOKEN_URI' | 'INVALID_TOKEN_URI_SCHEME' | 'UNREACHABLE_TOKEN_URI' | 'THROTTLED_TOKEN_URI' | 'METADATA_CONTENT_TOO_LARGE' | 'INVALID_METADATA' | 'INVALID_METADATA_JSON' | 'INDEXED' | 'UNINDEXED', required: The metadata indexing status of the nft.
          - `metadataLastUpdatedTimestamp` number
          - `name` string
          - `symbol` string
          - `imageUri` string
          - `description` string
          - `animationUri` string
          - `externalUrl` string
          - `background` string
          - `decimals` number
          - `properties` string
        - `chainId` string, required: The evm chain id.
        - `balance` string, required: The address balance for the token, in units specified by the `decimals` value for the contract.

## Other responses

- `400`: Bad requests generally mean the client has passed invalid or malformed parameters. Error messages in the response could help in evaluating the error.
- `401`: When a client attempts to access resources that require authorization credentials but the client lacks proper authentication in the request, the server responds with 401.
- `403`: When a client attempts to access resources with valid credentials but doesn't have the privilege to perform that action, the server responds with 403.
- `404`: The error is mostly returned when the client requests with either mistyped URL, or the passed resource is moved or deleted, or the resource doesn't exist.
- `429`: This error is returned when the client has sent too many, and has hit the rate limit.
- `500`: The error is a generic server side error that is returned for any uncaught and unexpected issues on the server side. This should be very rare, and you may reach out to us if the problem persists for a longer duration.
- `502`: This is an internal error indicating invalid response received by the client-facing proxy or gateway from the upstream server.
- `503`: The error is returned for certain routes on a particular Subnet. This indicates an internal problem with our Subnet node, and may not necessarily mean the Subnet is down or affected.

---

[API](https://skmtc.dev/avax/apis/data-api.md) - [All operations](https://skmtc.dev/avax/apis/data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avax/apis/data-api/revisions/86448a21e2b1?raw)