Query Item Offer – PlayerAuctions Help Center

GET api/v1/offers/item/{id}

Query a single item 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": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data":
  {
    "minUnitPerOrder": 1.000,
    "totalUnit": 2000,
    "instruction": "this is an instruction.",
    "deliveryGuarantee": 4,
    "discounts": [
      {
        "startPrice": 10.00,
        "discountRate": 1.00000
      },
      {
        "startPrice": 50.00,
        "discountRate": 2.00000
      },
      {
        "startPrice": 100.00,
        "discountRate": 5.00000
      }
    ],
    "categoryId": 3638,
    "serverId": 3638,
    "itemId": 1243,
    "itemPath": "290|1243",
    "screenShot": "https://cdn-image.azureedge.net/title-image/liutest6/202606090117171717.png",
    "itemsPerUnit": 10.000,
    "otherItem": "",
    "deliveryTime": 0,
    "rootItem": 290,
    "blobName": "202606090117171717.png",
    "gameId": 3637,
    "price": 5.0000,
    "offerDuration": 30,
    "title": "Offer Title",
    "offerDesc": "<p>Offer Description</p>",
    "offerId": 71394134,
    "isAgree": false,
    "memberId": 678694,
    "state": 1,
    "productType": "item"
  }
}

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	Item offer details.
data.minUnitPerOrder	decimal	Minimum units per order.
data.totalUnit	int	Total available units.
data.instruction	string	Special instructions for the offer.
data.deliveryGuarantee	int	Delivery guarantee time.
data.discounts	array	List of discount tiers.
data.discounts[].startPrice	decimal	Discount start price for the first discount.
data.discounts[].discountRate	decimal	Discount rate for the first discount.
data.categoryId	int	Category ID.
data.serverId	int	Server ID.
data.itemId	int	Item ID.
data.itemPath	string	Item path hierarchy.
data.screenShot	string	URL of the offer screenshot.
data.itemsPerUnit	decimal	Number of items per unit.
data.otherItem	string	Custom item name.
data.deliveryTime	int	Estimated delivery time.
data.rootItem	int	Root item ID.
data.blobName	string	Blob storage name for the image.
data.gameId	int	Game ID.
data.price	decimal	Offer price.
data.offerDuration	int	Offer duration in days.
data.title	string	Offer title.
data.offerDesc	string	Offer description (HTML format).
data.offerId	int	Unique offer identifier.
data.isAgree	boolean	Agreement status flag.
data.memberId	int	Seller member ID.
data.state	int	Offer state/status code.
data.productType	string	Type of product (e.g., "item").

iii. Error Response Example

Error Response

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