Search NFTs

Search NFTs by owner or claimer address

get

This endpoints allows you to search a paginated list of NFTs by owner or claimer address.

Authorizations

Path parameters

transferablestringrequired

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

projectIdintegerrequired

Query parameters

pagenumber | nullableoptional

limitnumber | nullableoptional

searchstringoptional

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

401

403

404

200

No body

Example

cURL

curl --location 'https://dev.underdogprotocol.com/v2/projects/n/5/nfts/search
--header 'Authorization: Bearer {token}'

JavaScript

const axios = require('axios');

let config = {
  method: 'get',
  url: 'https://dev.underdogprotocol.com/v2/projects/n/5/nfts/search?search=Fs7'
  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
}