Get NFT items list

Xsolla Developers

Get NFT items listClient-side

get/v2/project/{project_id}/items/nft

Gets an NFT items list for building a catalog.

Attention

All projects have the limitation to the number of items that you can get in the response. The default and maximum value is 50 items per response. To get more data page by page, use limit and offset fields.

Note

In general, the use of catalog of items is available without authorization.
Only authorized users can get a personalized catalog.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id

required

integer

Project ID. You can find this parameter in your Publisher Account next to the name of the project.

Example: 44056

query Parameters

limit	integer Limit for the number of elements on the page. Example: limit=50
offset	integer Number of the element from which the list is generated (the count starts from 0). Example: offset=0
locale	string Default: "en" Response language. Two-letter lowercase language code per ISO 639-1.
additional_fields[]	Array of strings The list of additional fields. These fields will be in the response if you send them in your request. Items Enum: "media_list" "order" "long_description" "custom_attributes"
country	string Two-letter uppercase country code per ISO 3166-1 alpha-2. Check the documentation for detailed information about countries supported by Xsolla and the process of determining the country. Example: country=US

Responses

200

List of NFT items was successfully received.

Request samples

Response samples

application/json

{"has_more": false,
"items": [{"sku": "nft_item_1",
"name": "Big Rocket",
"groups": [{"external_id": "accessory",
"name": "Accessory"
}
],
"attributes": [{"external_id": "stack_size",
"name": "Stack size",
"values": [{"external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "5"
}
]
}
],
"type": "nft",
"description": "Big Rocket - description",
"image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
"is_free": false,
"price": {"amount": "100.99",
"amount_without_discount": "100.99",
"currency": "USD"
},
"virtual_prices": [{"amount": 100,
"sku": "vc_test",
"is_default": true,
"amount_without_discount": 100,
"image_url": "http://image.png",
"name": "SHOTGUN FOR TRUE RAIDERS",
"type": "virtual_currency",
"description": "description"
}
],
"can_be_bought": true,
"limits": {"per_user": {"total": 1,
"available": 1
}
},
"is_minted": true,
"blockchain": "blockchain_name_1",
"token_id": "115792089237316195423570985008687907853269984665640564039457584007913129639930",
"smart_contract_address": "t1qskq33nssskznn0118oh355qjigmkpn8vekye6mctcgstrtrkibj2v7cf3tyk4ls05bdxr8nha02",
"cryptoaccount": "cryptoaccount_name_1",
"is_sales_exist": false
},
{"sku": "nft_item_2",
"name": "SHOTGUN FOR TRUE RAIDERS",
"groups": [{"external_id": "hair",
"name": "Hair"
}
],
"attributes": [{"external_id": "stack_size",
"name": "Stack size",
"values": [{"external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "5"
}
]
},
{"external_id": "rating",
"name": "Rating",
"values": [{"external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "3.9"
}
]
}
],
"type": "nft",
"description": "description",
"image_url": "http://image.png",
"is_free": false,
"price": {"amount": "101.0",
"amount_without_discount": "101.0",
"currency": "USD"
},
"virtual_prices": [{"amount": 100,
"sku": "vc_test",
"is_default": true,
"amount_without_discount": 100,
"image_url": "http://image.png",
"name": "SHOTGUN FOR TRUE RAIDERS",
"type": "virtual_currency",
"description": "description"
},
{"amount": 200,
"sku": "vc_test_2",
"is_default": false,
"amount_without_discount": 200,
"image_url": "http://image.png",
"name": "SHOTGUN FOR TRUE RAIDERS",
"type": "virtual_currency",
"description": "description"
}
],
"can_be_bought": true,
"limits": {"per_user": {"total": 1,
"available": 1
}
},
"is_minted": true,
"blockchain": "blockchain_name_2",
"token_id": "115792089237316195423570985008687907853269984665640564039457584007913129639931",
"smart_contract_address": "t1qskq33nssskznn0118oh355qjigmkpn8vekye6mctcgstrtrkibj2v7cf3tyk4ls05bdxr8nha02",
"cryptoaccount": "cryptoaccount_name_2",
"is_sales_exist": false
},
{"sku": "nft_item_3",
"name": "SHOTGUN FOR TRUE RAIDERS",
"groups": [ ],
"attributes": [ ],
"type": "nft",
"description": "description",
"image_url": "http://image.png",
"is_free": true,
"price": null,
"virtual_prices": [ ],
"can_be_bought": true,
"limits": {"per_user": {"total": 1,
"available": 0
}
},
"is_minted": true,
"blockchain": "blockchain_name_3",
"token_id": "115792089237316195423570985008687907853269984665640564039457584007913129639932",
"smart_contract_address": "t1qskq33nssskznn0118oh355qjigmkpn8vekye6mctcgstrtrkibj2v7cf3tyk4ls05bdxr8nha02",
"cryptoaccount": "cryptoaccount_name_3",
"is_sales_exist": true
}
]
}