1. Lists
itemdb API Guide
  • General
    • Getting Started
    • API Access
    • Slugs
    • Widget
      • Widget
      • Tab Example
  • v1
    • Item
      • Get latest items
      • Get an item
      • Get item's price history
      • Get item's auction history
      • Get item's restock history
      • Get item's trade history
      • Get items color palette
      • Get item's color palette
      • Get many items
      • Get many items
      • Get Item Drops Data
      • Get Dyeworks Variants
      • Get MME Paths
      • Get Item Effects
      • Get Cooking Pot Recipes
    • Search
      • Search for an item
    • Lists
      • Get List Info
      • Get List Item Info
      • Get List Item Data
    • Misc
      • Get all ways to change a Pet Color/Species
      • Get wearable preview
      • Get cached item's thumbnail
    • Schemas
      • Schemas
        • SaleStatus
        • ItemMallData
        • UseTypes
        • ListData
        • ListItemInfo
        • ItemData
        • itemColorData
        • ItemPriceData
        • OwlsData
        • ItemRestockData
        • ItemAuctionData
        • TradeData
        • TradeItem
        • UserList
        • ListItemInfo
        • ColorData
        • SearchFilters
  • v2
    • Intents & Cache
    • Items
      • Get a single item
      • Get many items
      • Get many items
    • Search
      • Search items
    • Lists
      • Get a list's items
        GET
    • Schemas
      • ItemIntent
      • ItemFlags
      • ItemPriceField
      • ItemPriceV2
      • NCValue
      • ItemSaleStatusV2
      • UseTypes
      • ThreeStateBoolean
      • ItemV2Minimal
      • ItemV2Card
      • ItemV2Pricer
      • ItemV2Full
      • Error
  1. Lists

Get a list's items

GET
https://itemdb.com.br/api/v2/lists/{username}/{list_id}/itemdata
ItemV2 counterpart of the v1 itemdata endpoint.
Cache: Reuses the shared per-item Redis cache for payloads. Public views may be CDN-cached (official lists longer than user lists). Requests with includeHidden=true or fresh=1 stay private (Cache-Control: no-store). Default intent is card.

Request

Path Params

Query Params

Responses

🟢200
application/json
List items as ItemV2. Shape depends on asObject.
Bodyapplication/json

Example
[
    {
        "internal_id": 0,
        "item_id": 0,
        "name": "string",
        "description": "string",
        "image": {
            "url": "string",
            "id": "string",
            "hash": "string"
        },
        "type": "np",
        "status": "string",
        "slug": "string"
    }
]
🟠400
🟠404
Modified at 2026-07-22 23:09:58
Previous
Search items
Next
ItemIntent
Built with