Query Topup Categories – PlayerAuctions Help Center

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

Query topup 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": [
    {
      "categoryId": 105,
      "categoryName": "Category- B",
      "deliveryType": 2,
      "deliveryTypeName": "Manual Top-Up",
      "quantityType": 1,
      "quantities": [
        {
            "id": 1515,
            "fixQuantity": 1,
            "bonusQuantity": 0
        },
        {
            "id": 1516,
            "fixQuantity": 5,
            "bonusQuantity": 2
        },
        {
            "id": 1517,
            "fixQuantity": 10,
            "bonusQuantity": 5
        }
      ]
    },
    {
      "categoryId": 104,
      "categoryName": "Category-A",
      "deliveryType": 1,
      "deliveryTypeName": "UID",
      "quantityType": 1,
      "quantities": [
        {
          "id": 1513,
          "fixQuantity": 50,
          "bonusQuantity": 10
        },
        {
          "id": 1514,
          "fixQuantity": 100,
          "bonusQuantity": 100
        }
      ]
    }
  ]
}

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 topup categories for the game.
data[].categoryId	int	Unique identifier for the category.
data[].categoryName	string	Name of the category.
data[].deliveryType	int	Delivery type code. 1 = UID, 2 = Manual Top-Up.
data[].deliveryTypeName	string	Name of the delivery type.
data[].quantityType	int	Type of quantity specification. 1 = Fix, 2 = Flexible.
data[].quantities	array	List of available quantity options for this category.
data[].quantities[].id	int	Unique identifier for the quantity option.
data[].quantities[].fixQuantity	int	Base quantity amount.
data[].quantities[].bonusQuantity	int	Bonus quantity amount included with this option.

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.