Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:48:32Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Auction}}
Sends an auction house search request to the server.

<pre>
SendAuctionSearch(minItemLevel, maxItemLevel, career, restrictionType, minTradeSkillLevel, maxTradeSkillLevel, rarity, itemTypes, itemEquipSlots, itemBonuses, itemName, sellerName)
</pre>

== Arguments ==
;minItemLevel : <code>number</code> – Lowest item level.
;maxItemLevel : <code>number</code> – Highest item level.
;career : <code>number</code> – Career filter.
;restrictionType : <code>number</code> – Restriction filter.
;minTradeSkillLevel : <code>number</code> – Lowest trade skill level.
;maxTradeSkillLevel : <code>number</code> – Highest trade skill level.
;rarity : <code>number</code> – Rarity filter.
;itemTypes : <code>number-table</code> – Array of item type numbers. May be empty.
;itemEquipSlots : <code>number-table</code> – Array of equipment slot numbers. May be empty.
;itemBonuses : <code>number-table</code> – Array of bonus numbers. May be empty.
;itemName : <code>wstring</code> – Text to search for in item names. <code>L""</code> for no name filter.
;sellerName : <code>wstring</code> – Seller name. <code>L""</code> for any seller.

== Returns ==
Nothing. The results arrive later from the server.

== Details ==
* The two item levels are rounded down and clamped to 1–40. If the minimum is 1 or less and the maximum is 40, or if the maximum is below the minimum, both are sent as 0.
* <code>career</code>, <code>restrictionType</code> and <code>rarity</code> are sent as single bytes (0–255). The trade skill levels are sent as 16-bit numbers.
* Every entry of the three tables is converted to a number and sent as a single byte. Entries of <code>itemEquipSlots</code> are translated by the client before sending.
* Each call increases a client-side search counter that is sent with the request.
* <code>itemName</code> and <code>sellerName</code> must be wide strings. A plain Lua string raises an ''Invalid Parameters'' error.
* The function needs at least twelve arguments and only reads the last twelve.

== Errors ==
None besides the generic ''Invalid Parameters'' message when an argument has the wrong type.

== Example ==
The stock UI fills a query table and passes its fields in order, from <code>default/ea_auctionhousewindow/source/auctionwindowlistdatamanager.lua</code>:
<pre>
function AuctionWindowListDataManager.SendAuctionSearch( queryData )
SendAuctionSearch( queryData.minItemLevel,
queryData.maxItemLevel,
queryData.career,
queryData.restrictionType,
queryData.minTradeSkillLevel,
queryData.maxTradeSkillLevel,
queryData.rarity,

queryData.itemTypes,
queryData.itemEquipSlots,
queryData.itemBonuses,

queryData.itemName,
queryData.sellerName
)
end
</pre>

Listing the player's own auctions, from the same file:
<pre>
function AuctionWindowListDataManager.SendPlayersAuctionSearch()
local queryData = AuctionWindowListDataManager.CreateEmptyQuery()
queryData.sellerName = GameData.Player.name
AuctionWindowListDataManager.SendAuctionSearch( queryData )
end
</pre>

== See also ==
* [[API:BuyAuction|BuyAuction]]
* [[API:CreateAuction|CreateAuction]]
* [[API:CancelAuction|CancelAuction]]

API:SendAuctionSearch - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)