Bulk Offer Upload – PlayerAuctions Help Center

POST api/v1/offers/bulk-upload

Bulk upload offers using an Excel file.

i. Request Parameters

Form Parameters

Parameter	Type	Required	Description
file	file	Yes	Excel file containing offer data for bulk upload. You can download a template from the api/v1/offers/bulk-template endpoint.
productType	string	Yes	Product type: "currency", "items", or "accounts".

ii. Response Example

Success Response

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "offerTotalCount": 3,
    "offers": [
      {
        "offerId": 71394128,
        "serverName": "WoW - Aegwynn - Alliance",
        "offerTitle": "Selling 1000G-50000G cheap! In stock; Buy Now!",
        "offerTitleUrl": "https://www-sandbox.playerauctions.com/wow-gold/71394128c!selling-1000g50000g-cheap-in-stock-buy-now/",
        "offerPrice": "$16.99",
        "offerPriceUnit": "per 500 K Gold"
      },
      {
        "offerId": 71394129,
        "serverName": "WoW - Aegwynn - Horde",
        "offerTitle": "Selling 1000G-50000G cheap! In stock; Buy Now!",
        "offerTitleUrl": "https://www-sandbox.playerauctions.com/wow-gold/71394129c!selling-1000g50000g-cheap-in-stock-buy-now/",
        "offerPrice": "$16.99",
        "offerPriceUnit": "per 500 K Gold"
      },
      {
        "offerId": 71394130,
        "serverName": "WoW - Aerie Peak - Alliance",
        "offerTitle": "Selling 1000G-50000G cheap! In stock; Buy Now!",
        "offerTitleUrl": "https://www-sandbox.playerauctions.com/wow-gold/71394130c!selling-1000g50000g-cheap-in-stock-buy-now/",
        "offerPrice": "$16.99",
        "offerPriceUnit": "per 500 K Gold"
      }
    ]
  }
}

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.offerTotalCount	int	Number of offers processed.
data.offers	array	Array of offers successfully created.
data.offers[].offerId	int	Offer ID.
data.offers[].serverName	string	Server name.
data.offers[].offerTitle	string	Offer title.
data.offers[].offerTitleUrl	string	Offer URL.
data.offers[].offerPrice	string	Offer price.
data.offers[].offerPriceUnit	string	Offer price per unit.

iii. Error Response Example

Error Response

{
  "code": 10002,
  "message": "Invalid parameter.",
  "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.