Inventory

Get User Inventory

get

Retrieves a user's inventory, including collections and points

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
200
Successful operation
application/json
get
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
    }
  ]
}

Last updated

Was this helpful?