Query Item Categories – PlayerAuctions Help Center

GET api/v1/games/{id}/items/categories

Query item categories for a specific game.

i. Request Parameters

Path Parameters

Parameter	Type	Required	Description
id	int	Yes	Game ID.

ii. Response Example

Success Response

{
  "code": 10000,
  "message": "Operation Successful.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": [
    {
      "id": 290,
      "productType": "Items",
      "name": "Money",
      "seoName": "Money",
      "parentId": 0,
      "itemSuffix": "",
      "sequence": 0,
      "subCategorys": [
        {
          "id": 1243,
          "productType": "SubItems",
          "name": "dolla",
          "seoName": "dolla",
          "parentId": 290,
          "itemSuffix": "K",
          "sequence": 0,
          "subCategorys": []
        },
        {
          "id": 1713,
          "productType": "SubItems",
          "name": "skill-05",
          "seoName": "skill-05",
          "parentId": 290,
          "itemSuffix": "",
          "sequence": 0,
          "subCategorys": []
        }
      ]
    }
  ]
}

Response Parameters

Parameter	Type	Description
code	int	Response code. 10000 indicates success, other values indicate an error.
message	string	Response message. Contains error details on failure.
requestId	string	Unique identifier for the request, used for tracking.
data	array	List of item categories. Each category contains the following fields: id (int): Category ID. productType (string): Product type, e.g., "Items", "SubItems". name (string): Category name. seoName (string): SEO-friendly name. parentId (int): Parent category ID, 0 indicates top-level category. itemSuffix (string): Suffix for items in this category. sequence (int): Display order. subCategorys (array): List of subcategories, with the same structure as parent category.

iii. Error Response Example

Error Response

{
  "code": 10002,
  "message": "Game not found.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

Common Error Codes

Parameter	Type	Description
code	int	Error code. Common values: 10002 (Invalid parameter), 50001 (Internal server error).
message	string	Detailed error message explaining what went wrong.
requestId	string	Unique identifier for the request, used for tracking.