LogoLogo
Developer DashboardMarketplaceDeveloper Discord
  • Getting Started
    • 👋Welcome to Altura
    • ➕Creating a Project
    • â›―Blockchains & Gas Fees
    • 🖞ïļMinting and Importing NFTs
      • Minting Individual NFTs
      • Importing Collections
      • Bulk Mint NFTs
      • Lazy Mint (Primary Sales)
    • 🔗Linking Your Collections
    • ðŸ’ģThe Developer Wallet
    • 🧠Smart NFTs
    • 🎁Lootboxes
    • 🔑Getting Your API Key
    • ðŸŽŪIntegrating Altura
    • ðŸ‘ĨAuthenticating Users
      • Altura Guard (Legacy)
      • Altura Guard II
        • Integration
        • REST API Demo
  • Altura Intelligence
    • 🧑‍ðŸĶēNPC Engine
      • ðŸĪĩNPC Engine +
    • 🌎World Engine
    • ðŸ’ģPlay Wallet
    • 💁Concierge
  • Marketplace
    • 🛍ïļThe Altura Marketplace
    • ðŸŽŊListing Your Game on the Altura Marketplace
    • ✅Getting Your Collections Verified
    • ðŸŽĻCreate Your Own White-Label Marketplace
  • 🌐API Reference
    • Get Endpoints
      • Verify a User's Altura Guard Code
      • Get User
      • Get Many Users
      • Get a User's Items
      • Get Item
      • Get Items
      • Get an Item's Holders
      • Get an Item's History
      • Get Collection
      • Get Collections
      • Get a User's Item Balance
      • Get a User's ERC20 Balance
      • Get a User's Native Token Balance
      • Get a User's Domain Names (Space ID)
      • Get a User From Domain Name (Space ID)
    • Developer Wallet Endpoints
      • Transfer ERC1155
      • Bulk Transfer ERC1155
      • Mint New ERC1155 NFT
      • Mint Additional Supply of ERC1155
      • Transfer ERC721
      • Transfer ERC20
      • Consume an Item (ERC1155)
    • Smart NFT Endpoints
      • Update an Item's Property
      • Add New Properties
      • Remove Properties
      • Bulk Update an Item's Properties
      • Switch an Item's Primary Image
      • Add a New Image
      • Update an Item's Name & Description
      • Update a Collection's Metadata
    • Altura Guard II
      • Connect to user wallet
      • Revoke Connection
      • Check Connection
      • Transaction Requests
        • Polling Transaction Response
        • Submitting a signature request
        • Submitting a native transaction request
        • Submitting a contract transaction request
  • ⚙ïļUnity SDK Reference
    • Installation
    • Get Methods
      • Verify a User's Altura Guard Code
      • Get User
      • Get Users
      • Get Item
      • Get Items
      • Get an Item's Holders
      • Get an Item's History
      • Get Collection
      • Get Collections
      • Get a User's Item Balance
      • Get a User's ERC20 Balance
      • Get a User's Native Token Balance
    • Schemas
  • ⚙ïļJS SDK Reference
    • Installation
    • Get Methods
      • Verify a User's Altura Guard Code
      • Get User
      • Get Many Users
      • Get a User's Items
      • Get Item
      • Get Items
      • Get an Item's Holders
      • Get an Item's History
      • Get Collection
      • Get Collections
      • Get a User's Item Balance
      • Get a User's ERC20 Balance
      • Get a User's Native Token Balance
    • Developer Wallet Methods
      • Transfer ERC1155
      • Bulk Transfer ERC1155
      • Mint Additional Supply of ERC1155
      • Transfer ERC721
      • Transfer ERC20
      • Consume an Item (ERC1155)
    • Smart NFT Endpoints
      • Update an Item's Property
      • Add new Properties
      • Remove Properties
      • Bulk Update an Item's Properties
      • Switch an Item's Primary Image
      • Add a New Image
      • Update an Item's Name & Description
      • Update a Collections Metadata
    • Altura Guard II
      • Connect to a user's wallet
      • Revoke Connection
      • Check Connection
      • Transaction Requests
        • Submitting a signature request
        • Submitting a native transaction request
        • Submitting a contract transaction request
    • Connect to Web3 Wallet
    • Schemas
Powered by GitBook
On this page
  • Get many items
  • Returns an array of items
  1. API Reference
  2. Get Endpoints

Get Items

Get many items

Returns an array of items

GET https://api.alturanft.com/api/v2/item

You can add additional query parameters to filter documents by any property. i.e. ?name=Majd

Query Parameters

Name
Type
Description

perPage

Integer

The number of items to return

(default: 24)

page

Integer

The offset for returned items. Calculated as (page - 1) * perPage

(default: 1)

sortBy

String

The field to sort the items by (any field in the item schema may be used)

(default: mintDate)

sortDir

String

Choose to sort in ascending (asc) or descending (desc) order

(default: desc)

slim

Boolean

Returns a more condensed version of the items. Limits the item fields to: name, properties, tokenId, collectionAddress, supply, maxSupply, image, imageUrl, imageIndex, and imageCount

(default: false)

{
  "items": [
    {
      "collectionAddress": "0xc376976f9ed83c9e13dfd151fcbe16e7ce0b9767",
      "tokenId": 1,
      "name": " 1 - GOOSE",
      "properties": [
        
      ],
      "imageUrl": "https://altura-marketplace-1.s3.us-east-2.amazonaws.com/56-0xc376976f9ed83c9e13dfd151fcbe16e7ce0b9767-1_4e3ec0a3-a4e6-494c-a4e3-3cef75700843.gif",
      "description": "Goose base NFT"
    },
    {
      "collectionAddress": "0xb13f0d03e3e564d6713faae896b94edee1b26ab2",
      "tokenId": 5,
      "name": " AlturaMice #5 ",
      "properties": [
        
      ],
      "imageUrl": "https://altura-marketplace-1.s3.us-east-2.amazonaws.com/56-0xb13f0d03e3e564d6713faae896b94edee1b26ab2-5_63dc008c-fe1d-42d5-87f5-0435ea7c5df6.png",
      "description": "Part of the AlturaMice NFT collection - The SuperCool AlturaMice #5 - Only 4 will be minted"
    },
    {
      "collectionAddress": "0x3a6c44990e9dc17e6e52974acfb3af36ba941b30",
      "tokenId": 3548,
      "name": " AlturaNFT Ghosty + NFT Banner Image",
      "properties": [
        
      ],
      "imageUrl": "https://altura-marketplace-1.s3.us-east-2.amazonaws.com/56-0x3a6c44990e9dc17e6e52974acfb3af36ba941b30-3548_e5792357-d258-4fa2-803e-3acd750ae474.gif",
      "description": ""
    }
  ]
}
{
    // Response
}
Example: get all items from a collection

/api/v2/item?collectionAddress=0x78e99615063da7c12c247e6bc01240da00df77ae&slim=true

Response

{
  "items": [
    {
      "name": "Viking Fox - Common",
      "properties": [
        {
          "_id": "618aabce0886bf0004ca16a9",
          "name": "Rarity",
          "value": "Common",
          "static": true
        }
      ],
      "tokenId": 1,
      "collectionAddress": "0x78e99615063da7c12c247e6bc01240da00df77ae",
      "supply": 1800,
      "maxSupply": 1800,
      "image": "https://ipfs.io/ipfs/Qmbv29YjEdcFR8GXJLH4FsLTo7GQzj1xRdBwKe23wTzBJq",
      "imageUrl": "https://altura-marketplace-1.s3.us-east-2.amazonaws.com/56-0x78e99615063da7c12c247e6bc01240da00df77ae-1_c1f87b2f-37b5-494d-bef0-0899bbb51357.png",
      "imageIndex": 3,
      "imageCount": 4
    },
    {
      "name": "Chef Fox - Common",
      "properties": [
        {
          "name": "Rarity",
          "value": "Common",
          "static": true
        }
      ],
      "tokenId": 2,
      "collectionAddress": "0x78e99615063da7c12c247e6bc01240da00df77ae",
      "supply": 1800,
      "maxSupply": 1800,
      "image": "https://ipfs.io/ipfs/QmNTuoAPTffe2vnE1Ks7G1MMDBmD24XGNypcCcTaJgXgry",
      "imageUrl": "https://altura-marketplace-1.s3.us-east-2.amazonaws.com/56-0x78e99615063da7c12c247e6bc01240da00df77ae-2_1e96ed76-931d-48ae-9f9b-5358cdbd6781.png",
      "imageIndex": 3,
      "imageCount": 4
    },
    ...
  ],
  "count": 25
}
PreviousGet ItemNextGet an Item's Holders

Last updated 2 years ago

🌐