---
title: "List NFTs by account address"
method: GET
path: "/v1/chains/{chain_name}/accounts/{account_address}/nfts"
tags: ["nfts"]
---

# List NFTs by account address

`GET /v1/chains/{chain_name}/accounts/{account_address}/nfts`

List NFTs by account address

## Path parameters

- `account_address` string, required
- `chain_name` string, required — The name of chain

## Query parameters

- `contract_address` string
- `token_id` string[]
- `from_updated_at` string, date-time
- `page_cursor` string — Encoded page cursor to retrieve previous or next page. Use the value returned in the response.
- `page_size` integer — Maximum number of items to return

## Response `200`

200 response

- ListNFTsByOwnerResult
  - `result` NFTWithBalance[], required — List of NFTs by owner
    - `chain` Chain, required — The chain details
      - `id` string, required — The id of chain
      - `name` string, required — The name of chain
    - `token_id` string, required — An `uint256` token id as string
    - `contract_address` string, required — The contract address of the NFT
    - `contract_type` 'ERC721' | 'ERC1155', required — The contract type for an NFT
    - `indexed_at` string, date-time, required — When the NFT was first indexed
    - `updated_at` string, date-time, required — When the NFT owner was last updated
    - `metadata_synced_at` string, date-time, nullable, required — When NFT metadata was last synced
    - `metadata_id` string, uuid, nullable — The id of the metadata of this NFT
    - `name` string, nullable, required — The name of the NFT
    - `description` string, nullable, required — The description of the NFT
    - `image` string, nullable, required — The image url of the NFT
    - `external_link` string, nullable, required — The external website link of NFT
    - `animation_url` string, nullable, required — The animation url of the NFT
    - `youtube_url` string, nullable, required — The youtube URL of NFT
    - `attributes` NFTMetadataAttribute[], required — List of Metadata attributes
      - `display_type` 'number' | 'boost_percentage' | 'boost_number' | 'date', nullable — Display type for this attribute
      - `trait_type` string, required — The metadata trait type
      - `value` union, required — The metadata trait value
        - string
        - number
        - boolean
    - `balance` string, required — The amount of this NFT this account owns
  - `page` Page, required — Pagination properties
    - `previous_cursor` string, nullable, required — First item as an encoded string
    - `next_cursor` string, nullable, required — Last item as an encoded string

## Other responses

- `400` — Bad Request (400)
- `404` — The specified resource was not found (404)
- `500` — Internal Server Error (500)

---

[API](https://skmtc.net/immutable/apis/immutable-zkevm-api.md) · [All operations](https://skmtc.net/immutable/apis/immutable-zkevm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/immutable/immutable-zkevm-api/versions/59f94155fcd0/schema)