List all NFTs

List all NFTs

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

get

/v2/projects/:transferable/:projectId/nfts

Authorizations

Path parameters

transferablestringrequired

Value must be either 't' for transferable or 'n' for non-transferable

projectIdintegerrequired

Query parameters

pagenumber | nullable

limitnumber | nullable

ownerAddressstring

Base-58 encoded string representing an on-chain address

Example: EBeLw5jEdrEgDe17BdKGW2MizzGxtxigEuAGvYC7VzDp

Pattern: ^[A-HJ-NP-Za-km-z1-9]*$

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.underdogprotocol.com/v2/projects/:transferable/:projectId/nfts' \
  --header 'Authorization: Bearer JWT'

200

401

403

404

200

No body

Example

cURL

curl --location 'https://dev.underdogprotocol.com/v2/projects/n/5/nfts?limit=10&page=1&ownerAddress=3LtsySLcKoW4VAp7pfSCGAFpwwuAVeqhe42fcc42aSpw' \
--header 'Authorization: Bearer {token}'

JavaScript

const axios = require('axios');

let config = {
  method: 'get',
  url: 'https://dev.underdogprotocol.com/v2/projects/n/5/nfts?limit=10&page=1&ownerAddress=3LtsySLcKoW4VAp7pfSCGAFpwwuAVeqhe42fcc42aSpw',
  headers: { 
    'Authorization': 'Bearer {token}'
  }
};

axios(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Response

{
    "results": [
        {
            "id": 4,
            "status": "confirmed",
            "transferable": false,
            "projectId": 5,
            "mintAddress": "Fs7pQhk6qfBZfHe8uEQkXYQZobNC4vbR3b5h947KBqk2",
            "claimerAddress": null,
            "ownerAddress": "3LtsySLcKoW4VAp7pfSCGAFpwwuAVeqhe42fcc42aSpw",
            "name": "Lazy Koalas",
            "description": "",
            "image": "https://underdog-test-bucket-dev.s3.amazonaws.com/Fs7pQhk6qfBZfHe8uEQkXYQZobNC4vbR3b5h947KBqk2/image.png",
            "attributes": {}
        }
    ],
    "page": 1,
    "limit": 10,
    "totalPages": 1,
    "totalResults": 1
}