# Item
Player item APIs. Used to retrieve items owned by the player, including minting status and usability in-game.
## Get item details
> Retrieves detailed information of a specific item by its unique ID.\
> \
> This API returns full item metadata including:\
> \- Base item information (name, category, image, description)\
> \- Gameplay properties (custom attributes)\
> \- NFT minting status and blockchain data\
> \- Marketplace listing status\
> \- Ownership and wallet information\
> \
> The request \*\*requires authentication\*\*.\
> The Bearer token \*\*must be the \`sessionId\`\*\* returned from the Login API.\
> \
> This API is designed for \*\*game developers without their own backend\*\*,\
> using the Sverse backend and authentication services.
```json
{"openapi":"3.0.3","info":{"title":"Sverse Managed Backend (Client SDK)","version":"1.0.0"},"tags":[{"name":"Item","description":"Player item APIs.\nUsed to retrieve items owned by the player,\nincluding minting status and usability in-game.\n"}],"servers":[{"url":"https://be.sverse.io","description":"Sverse Managed Backend (Production)"}],"security":[{"sessionAuth":[]}],"components":{"securitySchemes":{"sessionAuth":{"type":"http","scheme":"bearer","bearerFormat":"sessionId","description":"Use the `sessionId` returned from the Login API.\nExample:\nAuthorization: Bearer 9d7b6121-30d3-44cf-8b4f-c00e2f4f016e\n"}}},"paths":{"/api/public/items/{id}":{"get":{"tags":["Item"],"summary":"Get item details","description":"Retrieves detailed information of a specific item by its unique ID.\n\nThis API returns full item metadata including:\n- Base item information (name, category, image, description)\n- Gameplay properties (custom attributes)\n- NFT minting status and blockchain data\n- Marketplace listing status\n- Ownership and wallet information\n\nThe request **requires authentication**.\nThe Bearer token **must be the `sessionId`** returned from the Login API.\n\nThis API is designed for **game developers without their own backend**,\nusing the Sverse backend and authentication services.\n","operationId":"getItemById","parameters":[{"name":"id","in":"path","required":true,"description":"Unique identifier of the item","schema":{"type":"string"}}],"responses":{"200":{"description":"Item retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["error","data"],"properties":{"error":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"image":{"type":"string","format":"uri"},"itemDefId":{"type":"string"},"itemId":{"type":"string"},"props":{"type":"object","additionalProperties":true},"mint":{"type":"object","properties":{"isMinted":{"type":"boolean"},"status":{"type":"string"},"chainId":{"type":"string"},"nftAddress":{"type":"string"},"walletAddress":{"type":"string"}}},"listing":{"type":"object","properties":{"isListing":{"type":"boolean"},"price":{"type":"number"}}},"ownership":{"type":"object","properties":{"ownerType":{"type":"string"},"walletOwnerId":{"type":"string"}}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}},"400":{"description":"Invalid item ID","content":{"application/json":{}}},"404":{"description":"Item not found","content":{"application/json":{}}},"429":{"description":"Too many requests","content":{"application/json":{}}},"500":{"description":"Internal server error","content":{"application/json":{}}}}}}}}
```
## Get items of a user
> Retrieves a paginated list of items owned by a specific user.\
> \
> This API supports pagination, sorting, and advanced filtering,\
> allowing game clients to efficiently build inventory screens,\
> NFT galleries, or marketplace views.\
> \
> Supported features include:\
> \- Pagination (\`page\`, \`limit\`)\
> \- Sorting by item fields\
> \- Filtering by category, mint status, and listing status\
> \
> The request \*\*requires authentication\*\*.\
> The Bearer token \*\*must be the \`sessionId\`\*\* returned from the Login API.\
> \
> This API is intended for \*\*game developers without their own backend\*\*,\
> using the Sverse backend and authentication services.
```json
{"openapi":"3.0.3","info":{"title":"Sverse Managed Backend (Client SDK)","version":"1.0.0"},"tags":[{"name":"Item","description":"Player item APIs.\nUsed to retrieve items owned by the player,\nincluding minting status and usability in-game.\n"}],"servers":[{"url":"https://be.sverse.io","description":"Sverse Managed Backend (Production)"}],"security":[{"sessionAuth":[]}],"components":{"securitySchemes":{"sessionAuth":{"type":"http","scheme":"bearer","bearerFormat":"sessionId","description":"Use the `sessionId` returned from the Login API.\nExample:\nAuthorization: Bearer 9d7b6121-30d3-44cf-8b4f-c00e2f4f016e\n"}}},"paths":{"/api/public/users/items":{"get":{"tags":["Item"],"summary":"Get items of a user","description":"Retrieves a paginated list of items owned by a specific user.\n\nThis API supports pagination, sorting, and advanced filtering,\nallowing game clients to efficiently build inventory screens,\nNFT galleries, or marketplace views.\n\nSupported features include:\n- Pagination (`page`, `limit`)\n- Sorting by item fields\n- Filtering by category, mint status, and listing status\n\nThe request **requires authentication**.\nThe Bearer token **must be the `sessionId`** returned from the Login API.\n\nThis API is intended for **game developers without their own backend**,\nusing the Sverse backend and authentication services.\n","operationId":"getUserItems","parameters":[{"name":"page","in":"query","description":"Page number (starting from 1)","schema":{"type":"integer"}},{"name":"limit","in":"query","description":"Number of items per page","schema":{"type":"integer"}},{"name":"sortBy","in":"query","description":"Field used for sorting","schema":{"type":"string"}},{"name":"order","in":"query","description":"Sort order","schema":{"type":"string","enum":["asc","desc"]}},{"name":"filter[category]","in":"query","description":"Filter items by category","schema":{"type":"string"}},{"name":"filter[isMinted]","in":"query","description":"Filter items by mint (NFT) status","schema":{"type":"boolean"}},{"name":"filter[isListing]","in":"query","description":"Filter items by marketplace listing status","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Items retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["error","data","pagination"],"properties":{"error":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"mint":{"type":"object","properties":{"isMinted":{"type":"boolean"},"status":{"type":"string"}}},"listing":{"type":"object","properties":{"isListing":{"type":"boolean"},"price":{"type":"number"}}}}}},"pagination":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"}}}}}}}},"429":{"description":"Too many requests","content":{"application/json":{}}},"500":{"description":"Internal server error","content":{"application/json":{}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://sverse-1.gitbook.io/sverse-docs/api-reference/client/item.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.