Query Topup Offer – PlayerAuctions Help Center

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

Query a single top-up offer by ID.

i. Request Parameters

Path Parameters

Parameter	Type	Required	Description
id	int	Yes	Offer ID.

ii. Response Example

Success Response

{
  "code": 10000,
  "message": "Operation Successful.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "minUnitPerOrder": 10.000,
    "totalUnit": 2000,
    "currencyPerUnit": 10.000,
    "instruction": "Simple Instruction.",
    "deliveryGuarantee": 6,
    "discounts": [],
    "categoryId": 3638,
    "serverId": 3638,
    "deliveryTime": 0,
    "topUpCategoryId": 102,
    "deliveryType": 1,
    "deliveryTypeName": "UID",
    "gameId": 3637,
    "price": 5.0000,
    "offerDuration": 30,
    "title": "Simple Title",
    "offerDesc": "<p>Simple Description.</p>",
    "offerId": 71394388,
    "memberId": 678694,
    "state": 1,
    "productType": "topup"
  }
}

Error Response

{
  "code": 10002,
  "message": "Offer 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	object	Top-up offer details.
└─ minUnitPerOrder	decimal	Minimum units required per order.
└─ totalUnit	int	Total available units for this offer.
└─ currencyPerUnit	decimal	Currency value per unit.
└─ instruction	string	Instructions for the top-up process.
└─ deliveryGuarantee	int	Delivery guarantee time in hours.
└─ discounts	array	List of applicable discounts.
└─ categoryId	int	Faction ID (The {id} of the leaf node). You can get the server's tree-structured data from the api/v1/games/{id}/{type}/servers endpoint.
└─ serverId	int	Server ID {id}. You can get the server's tree-structured data from the api/v1/games/{id}/{type}/servers endpoint.
└─ deliveryTime	int	Estimated delivery time.
└─ topUpCategoryId	int	Top-up category ID.
└─ deliveryType	int	Type of delivery method. 1 (UID), 2 (Manual Top-Up).
└─ deliveryTypeName	string	Name of the delivery type (e.g., "UID", "Manual Top-Up").
└─ gameId	int	Game ID associated with the offer.
└─ price	decimal	Price of the offer.
└─ offerDuration	int	Duration of the offer in days.
└─ title	string	Title of the offer.
└─ offerDesc	string	HTML description of the offer.
└─ offerId	int	Unique identifier of the offer.
└─ memberId	int	Member ID of the offer creator.
└─ state	int	State of the offer (1 for active).
└─ productType	string	Type of product (e.g., "topup").