Query Item Offer – PlayerAuctions Help Center

GEThttps://seller-api.playerauctions.com/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": "",
    "rootItem": 290,
    "blobName": "202606090117171717.png",
    "gameId": 3637,
    "price": 5.0000,
    "offerDuration": 30,
    "title": "Offer Title",
    "offerDesc": "<p>Offer Description</p>",
    "offerId": 71394134,
    "memberId": 678694,
    "state": 1,
    "productType": "item"
  }
}

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	Item offer details.
└─ minUnitPerOrder	decimal	Minimum units per order.
└─ totalUnit	int	Total available units.
└─ instruction	string	Special instructions for the offer.
└─ deliveryGuarantee	int	Delivery guarantee time.
└─ discounts	array	List of discount tiers.
└─ └─ startPrice	decimal	Discount start price for the first discount.
└─ └─ discountRate	decimal	Discount rate for the first discount.
└─ 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.
└─ itemId	int	Item ID.
└─ itemPath	string	Item path hierarchy.
└─ screenShot	string	Image URL for the offer.
└─ itemsPerUnit	decimal	Number of items per unit.
└─ otherItem	string	Custom item name.
└─ deliveryTime	int	Estimated delivery time.
└─ rootItem	int	Root item ID.
└─ blobName	string	Blob storage name for the image.
└─ gameId	int	Game ID.
└─ price	decimal	Offer price.
└─ offerDuration	int	Offer duration in days.
└─ title	string	Offer title.
└─ offerDesc	string	Offer description (HTML format).
└─ offerId	int	Unique offer identifier.
└─ memberId	int	Seller member ID.
└─ state	int	Current state of the offer (0 closed, 1 active, 3 hidden).
└─ productType	string	Type of product (e.g., "item").