Inventory

Get User Inventory

Retrieves a user's inventory, including collections and points

get

/users/{platform}//{platformUserId}/inventory

Authorizations

Path parameters

platformstringrequired

The platform identifier (e.g., "discord", "roblox")

Example: discord

platformUserIdstringrequired

The user's ID on the specified platform

Example: 123456789012345678

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.giftoin.org/api/v1/users/{platform}/{platformUserId}/inventory' \
  --header 'x-gft_api_key: YOUR_API_KEY'

200

400

401

200

{
  "collections": [
    {
      "id": "collection_123",
      "name": "Winter Collection",
      "description": "Limited edition winter cards",
      "cards": [
        {
          "id": "card_456",
          "name": "Snowflake Card",
          "image": "https://example.com/images/snowflake.png",
          "quantity": 2,
          "rarity": "rare"
        }
      ]
    }
  ],
  "points": [
    {
      "name": "Gold Points",
      "id": "point_789",
      "image": "https://example.com/images/gold-point.png",
      "quantity": 150
    }
  ]
}

Successful operation