> For the complete documentation index, see [llms.txt](https://xerial.gitbook.io/xerial-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xerial.gitbook.io/xerial-doc/xerial-apis/xerial-global-wallets/get-global-inventory.md).

# Get Global Inventory

The endpoint "Get Global Inventory" allows you to retrieve the NFTs associated with a specific wallet address in the Polygon Network.

### Overview

{% hint style="success" %}

### Endpoint

* **Method:** GET
* **URL:** `/api/wallet/{address}/{chain}/global-inventory`
  {% endhint %}

### Parameters

* **`address`** (Path Parameter): Wallet address (string).
* **`chain`** (Path Parameter): Blockchain (string). Available values: `polygon only`.

### Responses

#### Success (Code 200)

{% code fullWidth="false" %}

```json
{
  "ownedNfts": [
    {
      "contract": {
        "address": "0xb4412c146Ec8b02c27045F1f969a87e2B900EB4C",
        "name": "Avatars",
        "symbol": "AVA",
        "totalSupply": null,
        "tokenType": "ERC721",
        "contractDeployer": "0x7cA139225dA1bC1cC88cA05A45aFF05E32E8c125",
        "deployedBlockNumber": 43924399,
        "openSeaMetadata": {
          "floorPrice": null,
          "collectionName": null,
          "collectionSlug": null,
          "safelistRequestStatus": null,
          "imageUrl": null,
          "description": null,
          "externalUrl": null,
          "twitterUsername": null,
          "discordUrl": null,
          "bannerImageUrl": null,
          "lastIngestedAt": "2024-01-03T17:12:35.000Z"
        },
        "isSpam": null,
        "spamClassifications": []
      },
      "tokenId": "6",
      "tokenType": "ERC721",
      "name": "Rongo Sunn",
      "description": "Player",
      "tokenUri": "https://ipfs.io/ipfs/QmbMRP8Vk3H8yko2FxxYe1WJwPfmYRQbgGqsHpwKGEDCmF",
      "image": {
        "cachedUrl": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png",
        "thumbnailUrl": null,
        "pngUrl": null,
        "contentType": null,
        "size": null,
        "originalUrl": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png"
      },
      "raw": {
        "tokenUri": "https://purple-jealous-spoonbill-384.mypinata.cloud/ipfs/QmbMRP8Vk3H8yko2FxxYe1WJwPfmYRQbgGqsHpwKGEDCmF",
        "metadata": {
          "name": "Rongo Sunn",
          "description": "Player",
          "image": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png",
          "externalUrl": "https://joko.xerial.io/",
          "animationUrls": [],
          "attributes": [],
          "contract": {
            "address": "0xb4412c146Ec8b02c27045F1f969a87e2B900EB4C",
            "name": "Avatars",
            "symbol": "AVA",
            "image": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/2f2f53a5f69ad6d9b5cea7fbe3299587f86f7b002aef0a739d6dc34cd6dff7ef-_%20%284%29.jpeg",
            "description": "Ava",
            "externalUrl": "https://google.com"
          },
          "maxSupply": "5",
          "edition": 1
        },
        "error": null
      },
      "collection": null,
      "mint": {
        "mintAddress": "0xb49c7417661a4d4b46fa64be91ff93d80d163a82",
        "blockNumber": 44364249,
        "timestamp": "2024-01-04T00:26:12Z",
        "transactionHash": "0x09fc3dd8ca7fa06b9d4a462da22afbf5d3e8cd982eda9bc311e1e0f3d0aa80f4"
      },
      "owners": null,
      "timeLastUpdated": "2024-01-05T18:01:53.073Z",
      "balance": "1",
      "acquiredAt": {
        "blockTimestamp": null,
        "blockNumber": null
      }
    },
    {
      "contract": {
        "address": "0xb4412c146Ec8b02c27045F1f969a87e2B900EB4C",
        "name": "Avatars",
        "symbol": "AVA",
        "totalSupply": null,
        "tokenType": "ERC721",
        "contractDeployer": "0x7cA139225dA1bC1cC88cA05A45aFF05E32E8c125",
        "deployedBlockNumber": 43924399,
        "openSeaMetadata": {
          "floorPrice": null,
          "collectionName": null,
          "collectionSlug": null,
          "safelistRequestStatus": null,
          "imageUrl": null,
          "description": null,
          "externalUrl": null,
          "twitterUsername": null,
          "discordUrl": null,
          "bannerImageUrl": null,
          "lastIngestedAt": "2024-01-03T17:12:35.000Z"
        },
        "isSpam": null,
        "spamClassifications": []
      },
      "tokenId": "7",
      "tokenType": "ERC721",
      "name": "Rongo Sunn",
      "description": "Player",
      "tokenUri": "https://ipfs.io/ipfs/QmbMRP8Vk3H8yko2FxxYe1WJwPfmYRQbgGqsHpwKGEDCmF",
      "image": {
        "cachedUrl": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png",
        "thumbnailUrl": null,
        "pngUrl": null,
        "contentType": null,
        "size": null,
        "originalUrl": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png"
      },
      "raw": {
        "tokenUri": "https://purple-jealous-spoonbill-384.mypinata.cloud/ipfs/QmbMRP8Vk3H8yko2FxxYe1WJwPfmYRQbgGqsHpwKGEDCmF",
        "metadata": {
          "name": "Rongo Sunn",
          "description": "Player",
          "image": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/d8f646ba9597ad9db1811b3484bd36afb92974f64ea48ead66c0e3042edb08ee-Screen%20Shot%202023-12-27%20at%2016.13.00.png",
          "externalUrl": "https://joko.xerial.io/",
          "animationUrls": [],
          "attributes": [],
          "contract": {
            "address": "0xb4412c146Ec8b02c27045F1f969a87e2B900EB4C",
            "name": "Avatars",
            "symbol": "AVA",
            "image": "https://xerial-main-bucket.s3.us-east-1.amazonaws.com/2f2f53a5f69ad6d9b5cea7fbe3299587f86f7b002aef0a739d6dc34cd6dff7ef-_%20%284%29.jpeg",
            "description": "Ava",
            "externalUrl": "https://google.com"
          },
          "maxSupply": "5",
          "edition": 1
        },
        "error": null
      },
      "collection": null,
      "mint": {
        "mintAddress": "0xb49c7417661a4d4b46fa64be91ff93d80d163a82",
        "blockNumber": 44392816,
        "timestamp": "2024-01-04T17:18:23Z",
        "transactionHash": "0x2cec711a07f49242c3ed5a058f7b94e50e653053c39e585b23bf554653832e81"
      },
      "owners": null,
      "timeLastUpdated": "2024-01-05T18:01:53.082Z",
      "balance": "1",
      "acquiredAt": {
        "blockTimestamp": null,
        "blockNumber": null
      }
    }
  ],
  "totalCount": 2,
  "validAt": {
    "blockNumber": 44433072,
    "blockHash": "0x8aaf90505c7b9ed4f4acaa7e74072a50974afa39b375ccff6251d19904ddfe84",
    "blockTimestamp": "2024-01-05T18:01:51Z"
  },
  "pageKey": null
}
```

{% endcode %}

* **Media Type**: application/json.
* **Example Value**:  An object containing the information of the NFTs of an address and the total amount it owns in the Polygon Network.

**Internal Server Error (Code 500)**

```json
{
  "error": "Internal Server Error"
}
```

* **Media Type**: application/json
* **Example Value**: An error response indicating an internal server error.

## Usage

1. **Send a GET request** to the `/api/wallet/{address}/{chain}/global-inventory` endpoint to retrieve NFT balances.
2. **Handle the response accordingly** based on success or internal server error.

**Note:** Ensure the wallet address and blockchain chain are valid.