Query Topup Categories – PlayerAuctions Help Center

GEThttps://seller-api.playerauctions.com/api/v1/games/{id}/topup/categories

Query top-up 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
        }
      ]
    }
  ]
}

Error Response

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

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