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 | nullableOptional

searchstringOptional

Responses

200Success

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

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
}