---
title: "List all NFTs"
method: GET
path: "/v2/projects/{projectId}/nfts"
tags: ["Projects"]
---

# List all NFTs

`GET /v2/projects/{projectId}/nfts`

This endpoints allows you to retrieve a paginated list of all NFTs in a Project.

## Path parameters

- `projectId` integer, required

## Query parameters

- `page` number, nullable — Page number
- `limit` number, nullable — Items per page
- `sortBy` string
- `order` 'asc' | 'desc'
- `ownerAddress` string — Base-58 encoded string representing an on-chain address
- `identifier` string
- `namespace` string

## Response `200`

Successful response

- GetNftsResponse
  - `results` object[], required
    - `name` string, required — Name stored as on-chain metadata
    - `symbol` string — Symbol stored as on-chain metadata
    - `description` string — Description stored in the metadata
    - `image` string, required — Image for your NFT. When creating an NFT, this can be a base64 encoded string or a URL pointing to an image.
    - `animationUrl` string — URL pointing to the asset's animation.
    - `externalUrl` string — URL pointing to an external URL defining the asset
    - `attributes` object — Key-value pairs of your NFT attributes
    - `id` number, required — Unique ID for an NFT in a Project
    - `projectId` number — The ID of the Project the NFT is part of
    - `transferable` boolean — Whether or not the NFT can be transferred based on the Project its a part of
    - `compressed` boolean — Whether or not the NFTs in the Project are compressed
    - `mintAddress` string, required — Base-58 encoded string representing an on-chain address
    - `ownerAddress` string — Wallet address for the NFT's owner
    - `claimerAddress` string — Wallet address allowed to claim the NFT
    - `status` string, required
  - `page` number, required — Page number
  - `limit` number, required — Number per page
  - `totalPages` number, required — Total number of pages
  - `totalResults` number, required — Total number of results

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/underdogprotocol/apis/underdog-protocol-api.md) · [All operations](https://skmtc.net/underdogprotocol/apis/underdog-protocol-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/underdogprotocol/underdog-protocol-api/versions/714574b82cc5/schema)