Inventory

Get User Inventory

get

Retrieves a user's inventory, including collections and points

Authorizations

ApiKeyAuth

x-gft_api_keystringRequired

API key for authentication (can also use x-gft-api-key or gft-api-key)

Path parameters

platformstringRequired

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

Example: discord

platformUserIdstringRequired

The user's ID on the specified platform

Example: 123456789012345678

Responses

200

Successful operation

application/json

Contains the complete inventory of a user, including all collections and points

400

Bad Request - Missing or invalid parameters

application/json

401

Unauthorized - API key is missing or invalid

application/json

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

HTTPcURLJavaScriptPython

GET /api/v1/users/{platform}/{platformUserId}/inventory HTTP/1.1
Host: api.giftoin.org
x-gft_api_key: YOUR_API_KEY
Accept: */*

{
  "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
    }
  ]
}