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

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

transferablestringRequired

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

projectIdintegerRequired

Query parameters

pagenumber · nullableOptional

limitnumber · max: 100 · nullableOptional

searchstringOptional

Responses

200Success

No content

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

get/v2/projects/:transferable/:projectId/nfts/search

HTTPcURLJavaScriptPython

GET /v2/projects/:transferable/:projectId/nfts/search HTTP/1.1
Host: api.underdogprotocol.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

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
}